Nuxt UI v4

Component library for Vue 3 and Nuxt 4+ built on Reka UI (headless) + Tailwind CSS v4 + Tailwind Variants.

Current stable version: v4.4.0 (January 2026)

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, prefix, tree-shaking

references/theming.md Semantic colors, CSS variables, app.config.ts, Tailwind Variants

references/components.md Component index by category (125+ 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

Loading Files

Consider loading these reference files based on your task:

• references/installation.md - if installing or configuring @nuxt/ui

• references/theming.md - if customizing theme, colors, or Tailwind Variants

• references/components.md - if browsing component index or finding components by category

• references/forms.md - if building forms with validation (Zod/Valibot)

• references/overlays.md - if using Toast, Modal, Slideover, Drawer, or CommandPalette

• references/composables.md - if using useToast, useOverlay, or other composables

DO NOT load all files at once. Load only what's relevant to your current task.

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

• Nuxt UI Docs

• Component Reference

• Theme Customization

Token efficiency: Main skill ~300 tokens, each sub-file ~800-1200 tokens