---
title: "UI and icons"
description: "Add Nuxt UI to an app and bundle the icon collections it uses."
canonical_url: "https://docs.dev.lightdrop.cloud/guides/ui-icons"
---
# UI and icons

> Add Nuxt UI to an app and bundle the icon collections it uses.

wervt apps can use any Vue UI library. For tools, dashboards and forms, Nuxt UI is the usual pick:

```bash
pnpm add @nuxt/ui
```

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  modules: ['@wervt/nuxt', '@nuxt/ui'],
})
```

## Bundle the icons

Nuxt UI (through `@nuxt/icon`) normally loads icons it doesn't have locally from the Iconify API.
An app's isolate can't reach that API, so every icon collection the app uses has to be installed,
or icons like `i-lucide-chevron-down` stay blank (select arrows, tab and button icons).

Install each collection as a dev dependency. Nuxt UI's own icons are Lucide:

```bash
pnpm add -D @iconify-json/lucide
pnpm add -D @iconify-json/simple-icons   # one package per other prefix you use: i-simple-icons-…
```

`@nuxt/icon` bundles the installed collections into the server build by itself. `@wervt/nuxt`
stops the server from falling back to the Iconify API and warns during `nuxt build` when no
collection is installed (for Nuxt UI: when Lucide is missing). The full `@iconify/json` package
works too, but it is large; prefer the single collections.


## Sitemap

See the full [sitemap](https://docs.dev.lightdrop.cloud/sitemap.md) for all pages.
