Skip to content

secondsky/claude-skills / plugins/nuxt-ui-v4/skills/nuxt-ui-v4

nuxt-ui-v4

Verified

Nuxt UI v4 component library for building Nuxt v4 applications. 125+ accessible components with Tailwind v4, Reka UI, dark mode, theming. Use for dashboards, forms, overlays, editors, page layouts, pricing pages, or encountering component, theming, or TypeScript errors.

FileKindSize
SKILL.mdskill md13.0 KB
references/COMMON_ERRORS_DETAILED.mdmarkdown24.7 KB
references/accessibility-patterns.mdmarkdown822 B
references/ai-sdk-v5-integration.mdmarkdown6.4 KB
references/auth-form.mdmarkdown6.4 KB
references/chat-components.mdmarkdown13.2 KB
references/chat-reasoning.mdmarkdown3.0 KB
references/chat-shimmer.mdmarkdown1.6 KB
references/chat-tool.mdmarkdown3.6 KB
references/command-palette-setup.mdmarkdown1.1 KB
references/common-components.mdmarkdown1.2 KB
references/component-theming-guide.mdmarkdown13.2 KB
references/composables-guide.mdmarkdown908 B
references/content-components.mdmarkdown7.3 KB
references/css-variables-reference.mdmarkdown14.9 KB
references/dark-mode-guide.mdmarkdown10.9 KB
references/dashboard-components.mdmarkdown8.1 KB
references/data-display-components.mdmarkdown11.7 KB
references/design-system-guide.mdmarkdown16.1 KB
references/editor-components.mdmarkdown7.9 KB
references/feedback-components-reference.mdmarkdown11.4 KB
references/form-advanced-patterns.mdmarkdown1.7 KB
references/form-components-reference.mdmarkdown14.0 KB
references/form-validation-patterns.mdmarkdown6.4 KB
references/i18n-integration.mdmarkdown12.8 KB
references/icon-system-guide.mdmarkdown14.5 KB
references/layout-components-reference.mdmarkdown9.5 KB
references/loading-feedback-patterns.mdmarkdown1.0 KB
references/navigation-components-reference.mdmarkdown8.8 KB
references/nuxt-content-integration.mdmarkdown15.7 KB
references/nuxt-v4-features.mdmarkdown8.0 KB
references/overlay-decision-guide.mdmarkdown1.3 KB
references/page-layout-components.mdmarkdown8.4 KB
references/performance-optimization.mdmarkdown12.8 KB
references/pricing-components.mdmarkdown7.7 KB
references/responsive-patterns.mdmarkdown795 B
references/semantic-color-system.mdmarkdown1.3 KB
references/tailwind-prefix-guide.mdmarkdown7.6 KB
references/typescript-setup.mdmarkdown10.8 KB
scripts/check-versions.shexecutablescript1.3 KB
templates/app.config.tsscript2.5 KB
templates/app.vueother1.1 KB
templates/components/ui-avatar-badge.vueother7.7 KB
templates/components/ui-card-layouts.vueother5.9 KB
templates/components/ui-carousel-gallery.vueother1.4 KB
templates/components/ui-chat-full.vueother3.4 KB
templates/components/ui-chat-interface.vueother8.8 KB
templates/components/ui-command-palette.vueother1.8 KB
templates/components/ui-content-prose.vueother7.2 KB
templates/components/ui-dark-mode-toggle.vueother7.4 KB
templates/components/ui-data-table.vueother7.1 KB
templates/components/ui-drawer-mobile.vueother5.2 KB
templates/components/ui-dropdown-menu.vueother6.3 KB
templates/components/ui-empty-state.vueother5.2 KB
templates/components/ui-feedback-states.vueother6.2 KB
templates/components/ui-form-example.vueother4.5 KB
templates/components/ui-input-date.vueother5.2 KB
templates/components/ui-input-time.vueother5.8 KB
templates/components/ui-modal-dialog.vueother8.0 KB
templates/components/ui-navigation-tabs.vueother7.2 KB
templates/components/ui-popover-tooltip.vueother2.6 KB
templates/components/ui-toast-notifications.vueother8.9 KB
templates/composables/useAIChat.tsscript2.9 KB
templates/composables/useI18nForm.tsscript9.6 KB
templates/composables/useNuxtUITheme.tsscript2.4 KB
templates/layouts/dashboard.vueother3.7 KB
templates/nuxt.config.tsscript1.3 KB
templates/pages/landing.vueother5.9 KB

references/form-components-reference.md

View on GitHub
# Form Components Reference

**Component Count**: 22 form components
**Purpose**: Complete reference for all Nuxt UI v4 form components with props, events, and slots

---

## Overview

Nuxt UI v4 provides 22 accessible form components built on Reka UI with automatic validation support via Standard Schema (Zod, Valibot, etc.).

**Form Components List**:
1. Input - Text inputs with leading/trailing icons
2. InputDate (v4.2+) - Date picker with range support
3. InputTime (v4.2+) - Time picker (12/24-hour)
4. InputMenu - Searchable dropdown input
5. InputNumber - Numeric input with steppers
6. InputTags - Tag/chip input
7. Select - Native select dropdown
8. SelectMenu - Custom searchable select
9. Textarea - Multi-line text input
10. Checkbox - Single checkbox
11. CheckboxGroup - Multiple checkboxes
12. RadioGroup - Radio button group
13. Switch - Toggle switch
14. Slider - Range slider
15. Calendar - Calendar date selection
16. ColorPicker - Color selection
17. PinInput - OTP/pin code input
18. FileUpload - File upload input
19. Form - Form validation wrapper
20. FormField - Form field with label/validation
21. FieldGroup - Group buttons/inputs together
22. AuthForm - Pre-built login/register/password reset form

---

## Input Component

### Basic Usage

```vue
<template>
  <UInput
    v-model="email"
    type="email"
    placeholder="Enter email"
    required
  />
</template>

<script setup lang="ts">
const email = ref('')
</script>
```

### With Icons

```vue
<template>
  <UInput
    v-model="search"
    placeholder="Search..."
    :ui="{
      icon: { leading: 'text-primary' }
    }"
  >
    <template #leading>
      <UIcon name="i-heroicons-magnifying-glass" />
    </template>

    <template #trailing>
      <UButton
        v-if="search"
        icon="i-heroicons-x-mark"
        variant="ghost"
        size="xs"
        @click="search = ''"
      />
    </template>
  </UInput>
</template>
```

### Key Props

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `v-model` | `string` | - | Input value (required) |
| `type` | `string` | `'text'` | HTML input type |
| `placeholder` | `string` | - | Placeholder text |
| `disabled` | `boolean` | `false` | Disable input |
| `loading` | `boolean` | `false` | Show loading state |
| `size` | `'xs' \| 'sm' \| 'md' \| 'lg'` | `'md'` | Input size |
| `color` | Semantic color | `'primary'` | Input color |
| `variant` | `'solid' \| 'outline' \| 'soft' \| 'subtle'` | `'outline'` | Input variant |

### Slots

- `leading` - Content before input (icons, buttons)
- `trailing` - Content after input (icons, buttons)

---

## InputDate Component (v4.2+)

### Basic Date Picker

```vue
<template>
  <UInputDate v-model="date" />
</template>

<script setup lang="ts">
import { CalendarDate } from '@internationalized/date'

const date = ref(new CalendarDate(2024, 1, 15))
</script>
```

### Date Range Selection

```vue
<template>
  <UInputDate
    v-model="dateRange"
    range
    separator-icon="i-heroicons-arrow-right"
  />
</template>

<script setup lang="ts">
import { CalendarDate } from '@internationalized/date'

const dateRange = ref({
  start: new CalendarDate(2024, 1, 1),
  end: new CalendarDate(2024, 1, 7)
})
</script>
```

### Unavailable Dates

```vue
<template>
  <UInputDate
    v-model="workDate"
    :is-date-unavailable="isWeekend"
    placeholder="Select weekday"
  />
</template>

<script setup lang="ts">
import { CalendarDate } from '@internationalized/date'

const workDate = ref(new CalendarDate(2024, 1, 15))

function isWeekend(date: CalendarDate) {
  const dayOfWeek = date.toDate('UTC').getDay()
  return dayOfWeek === 0 || dayOfWeek === 6  // Sunday or Saturday
}
</script>
```

### Key Props

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `v-model` | `CalendarDate \| { start, end }` | - | Selected date(s) |
| `range` | `boolean` | `false` | Enable range selection |
| `is-date-unavailable` | `(date) => boolean` | - | Function to disable dates |
| `separator-icon` | `string` | `'i-heroicons-minus'` | Range separator icon |
| `color` | Semantic color | `'primary'` | Calendar color |
| `size` | `'xs' \| 'sm' \| 'md' \| 'lg'` | `'md'` | Input size |

**Requires**: `@internationalized/date` package
```bash
bun add @internationalized/date
```

---

## InputTime Component (v4.2+)

### Basic Time Picker

```vue
<template>
  <UInputTime v-model="time" :hour-cycle="24" />
</template>

<script setup lang="ts">
import { Time } from '@internationalized/date'

const time = ref(new Time(14, 30))  // 2:30 PM
</script>
```

### 12-Hour Format

```vue
<template>
  <UInputTime
    v-model="time12"
    :hour-cycle="12"
    placeholder="Select time"
  />
</template>

<script setup lang="ts">
import { Time } from '@internationalized/date'

const time12 = ref(new Time(2, 30))  // 2:30 AM
</script>
```

### Key Props

| Prop | Type | Default | Description |
|------|------|---------|-------------|
| `v-model` | `Time` | - | Selected time |
| `hour-cycle` | `12 \| 24` | `24` | Time format |
| `color` | Semantic color | `'primary'` | Picker color |
| `size` | `'xs' \| 'sm' \| 'md' \| 'lg'` | `'md'` | Input size |
| `disabled` | `boolean` | `false` | Disable picker |

**Requires**: `@internationalized/date` package

---

## Select & SelectMenu Components

### Select (Native)

```vue
<template>
  <USelect
    v-model="selected"
    :options="options"
    placeholder="Select option"
  />
</template>

<script setup lang="ts">
const options = [
  { label: 'Option 1', value: 'opt1' },
  { label: 'Option 2', value: 'opt2' }
]
const selected = ref(null)
</script>
```

### SelectMenu (Custom, Searchable)

```vue
<template>
  <USelectMenu
    v-model="selected"
    :items="items"
    searchable
    placeholder="Search options..."
    value-key="id"
    label-key="name"
  />
</template>

<script setup lang="ts">
const items = [
  { id: 1, name: 'Apple', category: 'Fruit' },
  { id: 2, name: 'Carrot', category: 'Vegetable' }
]
const selected = ref(null)
</script>
```

### SelectMenu with Groups

```vue
<template>
  <USelectMenu
    v-model="selected"
    :items="groupedItems"
    searchable
  />
</template>

<script setup lang="ts">
const groupedItems = [
  {
    label: 'Fruits',
    items: [
      { label: 'Apple', value: 'apple' },
      { label: 'Banana', value: 'banana' }
    ]
  },
  {
    label: 'Vegetables',
    items: [
      { label: 'Carrot', value: 'carrot' },
      { label: 'Broccoli', value: 'broccoli' }
    ]
  }
]
</script>
```

---

## Form Validation with UForm

### Basic Form with Zod

```vue
<template>
  <UForm
    :state="state"
    :schema="schema"
    @submit="onSubmit"
    @error="onError"
  >
    <UFormField name="email" label="Email" required>
      <UInput v-model="state.email" type="email" />
    </UFormField>

    <UFormField name="password" label="Password" required>
      <UInput v-model="state.password" type="password" />
    </UFormField>

    <UFormField name="age" label="Age">
      <UInputNumber v-model="state.age" />
    </UFormField>

    <UButton type="submit">Submit</UButton>
  </UForm>
</template>

<script setup lang="ts">
import { z } from 'zod'

const schema = z.object({
  email: z.email({ error: 'Invalid email address' }),
  password: z.string().min(8, 'Password must be at least 8 characters'),
  age: z.number().min(18, 'Must be 18 or older').optional()
})

const state = reactive({
  email: '',
  password: '',
  age: undefined
})

async function onSubmit(data: any) {
  console.log('Valid data:', data)
  // API call here
}

function onError(errors: any) {
  console.error('Validation errors:', errors)
}
</script>
```

### Nested Forms

```vue
<template>
  <UForm :state="state" :schema="schema" @submit="onSubmit">
    <UFormField name="user.firstName" label="First Name">
      <UInput v-model="state.user.firstName" />
    </UFormField>

    <UFormField name="user.lastName" label="Last Name">
      <UInput v-model="state.user.lastName" />
    </UFormField>

    <UFormField name="address.street" label="Street">
      <UInput v-model="state.address.street" />
    </UFormField>

    <UButton type="submit">Submit</UButton>
  </UForm>
</template>

<script setup lang="ts">
import { z } from 'zod'

const schema = z.object({
  user: z.object({
    firstName: z.string().min(1),
    lastName: z.string().min(1)
  }),
  address: z.object({
    street: z.string().min(1),
    city: z.string().min(1)
  })
})

const state = reactive({
  user: {
    firstName: '',
    lastName: ''
  },
  address: {
    street: '',
    city: ''
  }
})
</script>
```

---

## Checkbox & CheckboxGroup

### Single Checkbox

```vue
<template>
  <UCheckbox
    v-model="agreed"
    label="I agree to the terms and conditions"
    required
  />
</template>

<script setup lang="ts">
const agreed = ref(false)
</script>
```

### CheckboxGroup

```vue
<template>
  <UCheckboxGroup
    v-model="selected"
    :items="options"
    label="Select your interests"
  />
</template>

<script setup lang="ts">
const options = [
  { label: 'Sports', value: 'sports' },
  { label: 'Music', value: 'music' },
  { label: 'Technology', value: 'tech' }
]
const selected = ref([])
</script>
```

---

## RadioGroup

```vue
<template>
  <URadioGroup
    v-model="selected"
    :items="options"
    label="Choose your plan"
  />
</template>

<script setup lang="ts">
const options = [
  { label: 'Free', value: 'free', description: 'For personal use' },
  { label: 'Pro', value: 'pro', description: 'For professionals' },
  { label: 'Enterprise', value: 'enterprise', description: 'For teams' }
]
const selected = ref('free')
</script>
```

---

## Switch & Slider

### Switch Component

```vue
<template>
  <USwitch
    v-model="enabled"
    label="Enable notifications"
  />
</template>

<script setup lang="ts">
const enabled = ref(false)
</script>
```

### Slider Component

```vue
<template>
  <USlider
    v-model="volume"
    :min="0"
    :max="100"
    :step="5"
  />
  <p>Volume: {{ volume }}</p>
</template>

<script setup lang="ts">
const volume = ref(50)
</script>
```

---

## ColorPicker

```vue
<template>
  <UColorPicker
    v-model="color"
    :swatches="presetColors"
  />
</template>

<script setup lang="ts">
const color = ref('#3B82F6')
const presetColors = [
  '#3B82F6', '#10B981', '#F59E0B', '#EF4444', '#8B5CF6'
]
</script>
```

---

## InputNumber

```vue
<template>
  <UInputNumber
    v-model="quantity"
    :min="1"
    :max="100"
    :step="1"
  />
</template>

<script setup lang="ts">
const quantity = ref(1)
</script>
```

---

## InputTags

```vue
<template>
  <UInputTags
    v-model="tags"
    placeholder="Add tags..."
  />
</template>

<script setup lang="ts">
const tags = ref(['vue', 'nuxt'])
</script>
```

---

## Textarea

```vue
<template>
  <UTextarea
    v-model="message"
    placeholder="Enter your message..."
    :rows="5"
    resize
  />
</template>

<script setup lang="ts">
const message = ref('')
</script>
```

---

## Common Patterns

### Form with Multiple Field Types

```vue
<template>
  <UForm :state="state" :schema="schema" @submit="onSubmit">
    <UFormField name="name" label="Full Name">
      <UInput v-model="state.name" />
    </UFormField>

    <UFormField name="email" label="Email">
      <UInput v-model="state.email" type="email" />
    </UFormField>

    <UFormField name="birthDate" label="Birth Date">
      <UInputDate v-model="state.birthDate" />
    </UFormField>

    <UFormField name="meetingTime" label="Preferred Meeting Time">
      <UInputTime v-model="state.meetingTime" :hour-cycle="12" />
    </UFormField>

    <UFormField name="country" label="Country">
      <USelectMenu
        v-model="state.country"
        :items="countries"
        searchable
      />
    </UFormField>

    <UFormField name="bio" label="Bio">
      <UTextarea v-model="state.bio" :rows="4" />
    </UFormField>

    <UFormField name="subscribe">
      <UCheckbox
        v-model="state.subscribe"
        label="Subscribe to newsletter"
      />
    </UFormField>

    <div class="flex gap-2">
      <UButton type="submit">Save</UButton>
      <UButton variant="ghost" @click="reset">Cancel</UButton>
    </div>
  </UForm>
</template>
```

---

## PinInput

```vue
<template>
  <UPinInput v-model="pin" :length="6" />
</template>

<script setup lang="ts">
const pin = ref([])
</script>
```

---

## AuthForm

Pre-built authentication form for login, register, and password reset flows.

```vue
<script setup lang="ts">
import * as z from 'zod'
import type { FormSubmitEvent, AuthFormField } from '@nuxt/ui'

const fields: AuthFormField[] = [
  { name: 'email', type: 'email', label: 'Email', placeholder: 'Enter your email', required: true },
  { name: 'password', label: 'Password', type: 'password', placeholder: 'Enter your password', required: true },
  { name: 'remember', label: 'Remember me', type: 'checkbox' }
]

const providers = [
  { label: 'Google', icon: 'i-simple-icons-google', onClick: () => handleGoogle() },
  { label: 'GitHub', icon: 'i-simple-icons-github', onClick: () => handleGitHub() }
]

const schema = z.object({
  email: z.email('Invalid email'),
  password: z.string('Password is required').min(8, 'Must be at least 8 characters')
})

function onSubmit(payload: FormSubmitEvent<z.output<typeof schema>>) {
  console.log('Submitted', payload)
}
</script>

<template>
  <UPageCard class="w-full max-w-md">
    <UAuthForm
      :schema="schema"
      title="Login"
      description="Enter your credentials to access your account."
      icon="i-lucide-user"
      :fields="fields"
      :providers="providers"
      @submit="onSubmit"
    />
  </UPageCard>
</template>
```

**Key Props**:
- `fields` - Array of field definitions (type determines component: checkbox→Checkbox, select→SelectMenu, otp→PinInput, else→Input)
- `providers` - Array of ButtonProps for OAuth buttons
- `schema` - Zod/Standard Schema for validation
- `separator` - Text between providers and fields (default: "or")
- `submit` - Submit button config (default: `{ label: 'Continue', block: true }`)

**Load `references/auth-form.md`** for complete API reference.

---

## Reference

- **Validation Patterns**: See `form-validation-patterns.md`
- **Advanced Patterns**: See `form-advanced-patterns.md`
- **Auth Form**: See `auth-form.md`
- **Templates**: See `templates/components/ui-form-example.vue`
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall