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/auth-form.md

View on GitHub
# AuthForm Component

A customizable Form to create login, register or password reset forms. Built on top of the Form component with field generation and provider support.

---

## Props

```ts
interface AuthFormProps {
  as?: any                                  // Element or component to render as
  icon?: any                                // Icon above the title
  title?: string                            // Form title
  description?: string                      // Form description
  fields?: AuthFormField[]                  // Auto-generated form fields
  providers?: ButtonProps[]                 // OAuth provider buttons
  separator?: string | SeparatorProps       // Separator between providers and fields (default: "or")
  submit?: Omit<ButtonProps, LinkPropsKeys> // Submit button config (default: { label: 'Continue', block: true })
  schema?: T                                // Zod/Standard Schema for validation
  validate?: Function                       // Custom validation function
  validateOn?: FormInputEvents[]            // When to validate
  disabled?: boolean                        // Disable entire form
  loading?: boolean                         // Show loading state
  loadingAuto?: boolean                     // Auto-detect loading from submit
  ui?: {                                    // Theme customization
    root?, header?, leading?, leadingIcon?, title?, description?,
    body?, providers?, checkbox?, select?, password?, otp?,
    input?, separator?, form?, footer?
  }
  // ...plus all native <form> HTML attributes
}
```

## Field Definition

```ts
interface AuthFormField {
  name: string
  type: 'checkbox' | 'select' | 'otp' | InputHTMLAttributes['type']
  label?: string
  placeholder?: string
  required?: boolean
  // Checkbox fields: accepts Checkbox props
  // Select fields: accepts SelectMenu props
  // OTP fields: accepts PinInput props
  // All other types: accepts Input props
  // Plus any FormField props
}
```

## Slots

- `header` - Custom header content
- `leading` - Before title
- `title` - Custom title
- `description` - Custom description
- `providers` - Custom provider buttons
- `validation` - Validation error display
- `submit` - Custom submit button
- `footer` - Footer content

## Events

- `@submit` - Form submission with typed data (`FormSubmitEvent`)

## Expose

Access via `useTemplateRef`:
- `formRef` - Reference to HTML form element
- `state` - Reactive form state

## Usage

### Basic Login Form

```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: () => handleGoogleLogin() },
  { label: 'GitHub', icon: 'i-simple-icons-github', onClick: () => handleGitHubLogin() }
]

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

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

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

### In a PageCard

```vue
<template>
  <div class="flex flex-col items-center justify-center gap-4 p-4">
    <UPageCard class="w-full max-w-md">
      <UAuthForm
        :schema="schema"
        :fields="fields"
        :providers="providers"
        title="Welcome back!"
        icon="i-lucide-lock"
        @submit="onSubmit"
      >
        <template #description>
          Don't have an account? <ULink to="#" class="text-primary font-medium">Sign up</ULink>.
        </template>
        <template #password-hint>
          <ULink to="#" class="text-primary font-medium" tabindex="-1">Forgot password?</ULink>
        </template>
        <template #validation>
          <UAlert color="error" icon="i-lucide-info" title="Error signing in" />
        </template>
        <template #footer>
          By signing in, you agree to our <ULink to="#" class="text-primary font-medium">Terms of Service</ULink>.
        </template>
      </UAuthForm>
    </UPageCard>
  </div>
</template>
```

### Register Form

```vue
<script setup lang="ts">
import type { AuthFormField } from '@nuxt/ui'

const fields: AuthFormField[] = [
  { name: 'name', type: 'text', label: 'Full Name', placeholder: 'Enter your name', required: true },
  { name: 'email', type: 'email', label: 'Email', placeholder: 'Enter your email', required: true },
  { name: 'password', type: 'password', label: 'Password', placeholder: 'Create a password', required: true },
  { name: 'confirmPassword', type: 'password', label: 'Confirm Password', placeholder: 'Confirm your password', required: true }
]
</script>

<template>
  <UAuthForm
    title="Create account"
    description="Fill in the details below to get started."
    icon="i-lucide-user-plus"
    :fields="fields"
    :submit="{ label: 'Create Account', block: true }"
    separator="Providers"
    @submit="onRegister"
  />
</template>
```

### OTP Verification

```vue
<script setup lang="ts">
import type { AuthFormField } from '@nuxt/ui'

const fields: AuthFormField[] = [
  { name: 'otp', type: 'otp', label: 'Verification Code' }
]
</script>

<template>
  <UAuthForm
    title="Verify your email"
    description="Enter the 6-digit code sent to your email."
    icon="i-lucide-shield-check"
    :fields="fields"
    :submit="{ label: 'Verify', block: true }"
    @submit="onVerify"
  />
</template>
```

## Theme

```ts
export default defineAppConfig({
  ui: {
    authForm: {
      slots: {
        root: 'w-full space-y-6',
        header: 'flex flex-col text-center',
        leading: 'mb-2',
        leadingIcon: 'size-8 shrink-0 inline-block',
        title: 'text-xl text-pretty font-semibold text-highlighted',
        description: 'mt-1 text-base text-pretty text-muted',
        body: 'gap-y-6 flex flex-col',
        providers: 'space-y-3',
        form: 'space-y-5',
        footer: 'text-sm text-center text-muted mt-2'
      }
    }
  }
})
```
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