nuxt-ui

Build styled Vue and Nuxt interfaces with @nuxt/ui v4 components, forms, and overlays.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/narr07/permadi --skill nuxt-ui-narr07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: nuxt-ui
Source: https://github.com/narr07/permadi/tree/main/.agents/skills/nuxt-ui
Command: npx skills add https://github.com/narr07/permadi --skill nuxt-ui-narr07

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building consistent, accessible UI in Nuxt 4+ projects requires knowing the correct @nuxt/ui v4 component APIs, theming system, and validation patterns, which are spread across extensive documentation. ## Core Features & Use Cases - Component Reference: Indexed guidance for 125+ components (Button, Table, Modal, Form, Editor) with key props, slots, and usage snippets. - Forms & Validation: Patterns for UForm with Standard Schema validation using Zod or Valibot, plus UFormField error handling. - Theming & Overlays: Tailwind Variants theming with semantic colors, plus programmatic overlays via useToast and useOverlay composables. - Use Case: When scaffolding a dashboard page, load the relevant component files to generate a UDashboardSidebar layout with a validated settings form and toast notifications. ## Quick Start Ask the AI to build a Nuxt page with a validated login form and a modal dialog using @nuxt/ui components.

Frequently Asked Questions about nuxt-ui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a validated form with @nuxt/ui?▼

Use UForm with a Standard Schema library like Zod or Valibot, binding a reactive state object and wrapping inputs in UFormField with a matching name prop. Validation runs automatically on submit, and errors display under each field.

How to show toast notifications in Nuxt UI v4?▼

Call useToast() and invoke toast.add() with title, description, color, and timeout options. Your app must be wrapped in the UApp component, which provides the global overlay context required for toasts to render.

Does @nuxt/ui v4 work with Tailwind CSS v4?▼

Yes, @nuxt/ui v4 is built on Tailwind CSS v4 and Tailwind Variants. You import both in your main CSS file with @import 'tailwindcss' and @import '@nuxt/ui', then register the module in nuxt.config.ts.

What is the difference between Nuxt UI and Reka UI?▼

Reka UI provides unstyled headless primitives handling accessibility and behavior, while @nuxt/ui wraps those primitives with Tailwind-based styling, theming, and Nuxt integration. Use Reka UI directly when you need full control over markup.

Why is my Modal or Toast not rendering in Nuxt UI?▼

Overlays require the UApp wrapper component at the root of your app, typically in app.vue around NuxtPage. Without it, useToast, useOverlay, Modal, and Tooltip have no mounting context and will fail silently.

How do I customize Nuxt UI theme colors?▼

Define semantic colors like primary and neutral in app.config.ts under the ui key, and map them to CSS variables in your main stylesheet. Tailwind Variants slots let you override per-component styles via the ui prop.