Nuxt UI v4
Component library for Vue 3 and Nuxt 4+ built on Reka UI (headless) + Tailwind CSS v4 + Tailwind Variants.
When to Use
- Installing/configuring @nuxt/ui
- Using UI components (Button, Card, Table, Form, etc.)
- Customizing theme (colors, variants, CSS variables)
- Building forms with validation
- Using overlays (Modal, Toast, CommandPalette)
- Working with composables (useToast, useOverlay)
For Vue component patterns: use vue skill
For Nuxt routing/server: use nuxt skill
Available Guidance
| File |
Topics |
| references/installation.md |
Nuxt/Vue setup, pnpm gotchas, UApp wrapper, module options |
| references/theming.md |
Semantic colors, CSS variables, app.config.ts, Tailwind Variants |
| references/components.md |
Component index by category (121 components) |
| components/*.md |
Per-component details (button.md, modal.md, etc.) |
| references/forms.md |
Form components, validation (Zod/Valibot), useFormField |
| references/overlays.md |
Toast, Modal, Slideover, Drawer, CommandPalette |
| references/composables.md |
useToast, useOverlay, defineShortcuts, useScrollspy |
Usage Pattern
Load based on context:
- Installing Nuxt UI? → references/installation.md
- Customizing theme? → references/theming.md
- Component index → references/components.md
- Specific component → components/button.md, components/modal.md, etc.
- Building forms? → references/forms.md
- Using overlays? → references/overlays.md
- Using composables? → references/composables.md
DO NOT read all files at once. Load based on context.
Key Concepts
| Concept |
Description |
| UApp |
Required wrapper component for Toast, Tooltip, overlays |
| Tailwind Variants |
Type-safe styling with slots, variants, compoundVariants |
| Semantic Colors |
primary, secondary, success, error, warning, info, neutral |
| Reka UI |
Headless component primitives (accessibility built-in) |
For headless component primitives (API details, accessibility patterns, asChild): read the reka-ui skill
Quick Reference
// nuxt.config.ts
export default defineNuxtConfig({
modules: ['@nuxt/ui'],
css: ['~/assets/css/main.css']
})
/* assets/css/main.css */
@import 'tailwindcss';
@import '@nuxt/ui';
<!-- app.vue - UApp wrapper required -->
<template>
<UApp>
<NuxtPage />
</UApp>
</template>
Resources
Token efficiency: Main skill ~300 tokens, each sub-file ~800-1200 tokens
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: nuxt-ui-73description: Use when building styled UI with @nuxt/ui v4 components (Button, Modal, Form, Table, etc.) - provides ready-to-use components with Tailwind Variants theming. Use vue skill for raw component patterns, reka-ui for headless primitives.4---56# Nuxt UI v478Component library for Vue 3 and Nuxt 4+ built on Reka UI (headless) + Tailwind CSS v4 + Tailwind Variants.910## When to Use1112- Installing/configuring @nuxt/ui13- Using UI components (Button, Card, Table, Form, etc.)14- Customizing theme (colors, variants, CSS variables)15- Building forms with validation16- Using overlays (Modal, Toast, CommandPalette)17- Working with composables (useToast, useOverlay)1819**For Vue component patterns:** use `vue` skill20**For Nuxt routing/server:** use `nuxt` skill2122## Available Guidance2324| File | Topics |25| ------------------------------------------------------------ | ---------------------------------------------------------------- |26| **[references/installation.md](references/installation.md)** | Nuxt/Vue setup, pnpm gotchas, UApp wrapper, module options |27| **[references/theming.md](references/theming.md)** | Semantic colors, CSS variables, app.config.ts, Tailwind Variants |28| **[references/components.md](references/components.md)** | Component index by category (121 components) |29| **components/\*.md** | Per-component details (button.md, modal.md, etc.) |30| **[references/forms.md](references/forms.md)** | Form components, validation (Zod/Valibot), useFormField |31| **[references/overlays.md](references/overlays.md)** | Toast, Modal, Slideover, Drawer, CommandPalette |32| **[references/composables.md](references/composables.md)** | useToast, useOverlay, defineShortcuts, useScrollspy |3334## Usage Pattern3536**Load based on context:**3738- Installing Nuxt UI? → [references/installation.md](references/installation.md)39- Customizing theme? → [references/theming.md](references/theming.md)40- Component index → [references/components.md](references/components.md)41- Specific component → [components/button.md](components/button.md), [components/modal.md](components/modal.md), etc.42- Building forms? → [references/forms.md](references/forms.md)43- Using overlays? → [references/overlays.md](references/overlays.md)44- Using composables? → [references/composables.md](references/composables.md)4546**DO NOT read all files at once.** Load based on context.4748## Key Concepts4950| Concept | Description |51| ----------------- | ---------------------------------------------------------- |52| UApp | Required wrapper component for Toast, Tooltip, overlays |53| Tailwind Variants | Type-safe styling with slots, variants, compoundVariants |54| Semantic Colors | primary, secondary, success, error, warning, info, neutral |55| Reka UI | Headless component primitives (accessibility built-in) |5657> For headless component primitives (API details, accessibility patterns, asChild): read the **reka-ui** skill5859## Quick Reference6061```ts62// nuxt.config.ts63export default defineNuxtConfig({64 modules: ['@nuxt/ui'],65 css: ['~/assets/css/main.css']66})67```6869```css70/* assets/css/main.css */71@import 'tailwindcss';72@import '@nuxt/ui';73```7475```vue76<!-- app.vue - UApp wrapper required -->77<template>78 <UApp>79 <NuxtPage />80 </UApp>81</template>82```8384## Resources8586- [Nuxt UI Docs](https://ui.nuxt.com)87- [Component Reference](https://ui.nuxt.com/components)88- [Theme Customization](https://ui.nuxt.com/getting-started/theme)8990---9192_Token efficiency: Main skill ~300 tokens, each sub-file ~800-1200 tokens_9394---95> Converted and distributed by [TomeVault](https://tomevault.io/claim/velidonmez) — claim your Tome and manage your conversions.96<!-- tomevault:4.0:skill_md:2026-04-15 -->