name: nuxt-ui description: 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. license: MIT

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

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

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