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/feedback-components-reference.md

View on GitHub
# Feedback Components Reference

**Components**: Toast, Notification, Alert, Progress, Skeleton, Empty (v4.2+)
**Purpose**: Complete reference for user feedback and loading states

---

## Toast Notifications

### Using useToast Composable

```vue
<template>
  <div class="space-y-2">
    <UButton @click="showSuccess">Show Success Toast</UButton>
    <UButton @click="showError" color="error">Show Error Toast</UButton>
    <UButton @click="showWithAction">Toast with Action</UButton>
  </div>
</template>

<script setup lang="ts">
const { add: addToast } = useToast()

function showSuccess() {
  addToast({
    title: 'Success!',
    description: 'Your changes have been saved.',
    color: 'success',
    icon: 'i-heroicons-check-circle',
    timeout: 3000
  })
}

function showError() {
  addToast({
    title: 'Error',
    description: 'Something went wrong. Please try again.',
    color: 'error',
    icon: 'i-heroicons-x-circle',
    timeout: 5000
  })
}

function showWithAction() {
  addToast({
    title: 'File deleted',
    description: 'Your file has been moved to trash.',
    color: 'warning',
    timeout: 10000,
    actions: [{
      label: 'Undo',
      click: () => {
        console.log('Undo clicked')
        // Restore file logic
      }
    }]
  })
}
</script>
```

### Toast Colors

```typescript
const { add } = useToast()

// Success toast
add({ title: 'Success', color: 'success' })

// Error toast
add({ title: 'Error', color: 'error' })

// Warning toast
add({ title: 'Warning', color: 'warning' })

// Info toast
add({ title: 'Info', color: 'info' })

// Neutral toast (default)
add({ title: 'Notification', color: 'neutral' })
```

### Toast Positioning

Configure toast position in `app.config.ts`:

```typescript
// app.config.ts
export default defineAppConfig({
  ui: {
    toast: {
      position: 'top-right'  // top-left, top-right, bottom-left, bottom-right
    }
  }
})
```

### Managing Toasts

```vue
<script setup lang="ts">
const { add, remove, clear } = useToast()

// Add toast and get ID
const toastId = add({
  title: 'Processing...',
  timeout: 0  // Don't auto-dismiss
})

// Remove specific toast
setTimeout(() => {
  remove(toastId)
}, 5000)

// Clear all toasts
function clearAll() {
  clear()
}
</script>
```

### Toast with Promise

```vue
<script setup lang="ts">
const { add, remove } = useToast()

async function saveData() {
  const toastId = add({
    title: 'Saving...',
    color: 'info',
    timeout: 0
  })

  try {
    await api.save(data)

    // Update toast to success
    remove(toastId)
    add({
      title: 'Saved!',
      color: 'success',
      timeout: 3000
    })
  } catch (error) {
    // Update toast to error
    remove(toastId)
    add({
      title: 'Save failed',
      description: error.message,
      color: 'error',
      timeout: 5000
    })
  }
}
</script>
```

---

## Notification Component

### Using useNotification Composable

```vue
<script setup lang="ts">
const { add: addNotification } = useNotification()

function showNotification() {
  addNotification({
    title: 'New message',
    description: 'You have a new message from John Doe',
    icon: 'i-heroicons-envelope',
    avatar: { src: '/john.jpg' },
    color: 'primary',
    timeout: 0  // Persistent notification
  })
}

function showWithAction() {
  addNotification({
    title: 'Update available',
    description: 'A new version is available. Click to update.',
    icon: 'i-heroicons-arrow-down-tray',
    color: 'info',
    actions: [{
      label: 'Update',
      click: () => performUpdate()
    }, {
      label: 'Dismiss',
      click: (close) => close()
    }]
  })
}
</script>
```

### Notification vs Toast

**Use Toast for**:
- Temporary feedback
- Success/error confirmations
- Auto-dismiss messages
- Bottom/top-right placement

**Use Notification for**:
- Persistent messages
- Inbox-style notifications
- User actions required
- Top-left/center placement

---

## Alert Component

### Basic Alert

```vue
<template>
  <div class="space-y-4">
    <UAlert
      color="success"
      title="Success"
      description="Your changes have been saved successfully."
      icon="i-heroicons-check-circle"
    />

    <UAlert
      color="error"
      title="Error"
      description="There was a problem processing your request."
      icon="i-heroicons-x-circle"
    />

    <UAlert
      color="warning"
      title="Warning"
      description="This action cannot be undone."
      icon="i-heroicons-exclamation-triangle"
    />

    <UAlert
      color="info"
      title="Information"
      description="New features have been added to your account."
      icon="i-heroicons-information-circle"
    />
  </div>
</template>
```

### Alert Variants

```vue
<template>
  <div class="space-y-4">
    <UAlert variant="solid" title="Solid" />
    <UAlert variant="outline" title="Outline" />
    <UAlert variant="soft" title="Soft" />
    <UAlert variant="subtle" title="Subtle" />
  </div>
</template>
```

### Alert with Actions

```vue
<template>
  <UAlert
    color="warning"
    title="Confirm deletion"
    description="Are you sure you want to delete this item?"
    :actions="[{
      label: 'Delete',
      color: 'error',
      click: () => handleDelete()
    }, {
      label: 'Cancel',
      variant: 'ghost',
      click: () => handleCancel()
    }]"
  />
</template>
```

### Closeable Alert

```vue
<template>
  <UAlert
    v-if="showAlert"
    title="Cookie notice"
    description="We use cookies to improve your experience."
    :close="{ click: () => showAlert = false }"
  />
</template>

<script setup lang="ts">
const showAlert = ref(true)
</script>
```

---

## Progress Component

### Basic Progress Bar

```vue
<template>
  <UProgress :value="progress" :max="100" />
</template>

<script setup lang="ts">
const progress = ref(0)

// Simulate progress
onMounted(() => {
  const interval = setInterval(() => {
    if (progress.value < 100) {
      progress.value += 10
    } else {
      clearInterval(interval)
    }
  }, 500)
})
</script>
```

### Progress Colors

```vue
<template>
  <div class="space-y-4">
    <UProgress :value="50" color="primary" />
    <UProgress :value="50" color="success" />
    <UProgress :value="50" color="warning" />
    <UProgress :value="50" color="error" />
  </div>
</template>
```

### Progress Sizes

```vue
<template>
  <div class="space-y-4">
    <UProgress :value="50" size="xs" />
    <UProgress :value="50" size="sm" />
    <UProgress :value="50" size="md" />
    <UProgress :value="50" size="lg" />
  </div>
</template>
```

### Progress with Label

```vue
<template>
  <div>
    <div class="flex justify-between mb-1">
      <span class="text-sm font-medium">Uploading...</span>
      <span class="text-sm text-gray-500">{{ progress }}%</span>
    </div>
    <UProgress :value="progress" :max="100" />
  </div>
</template>
```

### Indeterminate Progress

```vue
<template>
  <UProgress :value="null" color="primary" />
</template>
```

---

## Skeleton Loader

### Basic Skeleton

```vue
<template>
  <div v-if="loading">
    <USkeleton class="h-8 w-48 mb-4" />
    <USkeleton class="h-4 w-full mb-2" />
    <USkeleton class="h-4 w-3/4" />
  </div>
  <div v-else>
    <h1>{{ title }}</h1>
    <p>{{ content }}</p>
  </div>
</template>
```

### Card Skeleton

```vue
<template>
  <UCard>
    <div v-if="loading" class="space-y-4">
      <div class="flex items-center gap-3">
        <USkeleton class="h-12 w-12 rounded-full" />
        <div class="flex-1">
          <USkeleton class="h-4 w-32 mb-2" />
          <USkeleton class="h-3 w-48" />
        </div>
      </div>
      <USkeleton class="h-4 w-full" />
      <USkeleton class="h-4 w-5/6" />
      <USkeleton class="h-4 w-4/6" />
    </div>
    <div v-else>
      <!-- Actual content -->
    </div>
  </UCard>
</template>
```

### Table Skeleton

```vue
<template>
  <div v-if="loading" class="space-y-2">
    <USkeleton
      v-for="i in 5"
      :key="i"
      class="h-12 w-full"
    />
  </div>
  <UTable v-else :rows="rows" :columns="columns" />
</template>
```

---

## Empty Component (v4.2+)

### Basic Empty State

```vue
<template>
  <UEmpty
    icon="i-heroicons-inbox"
    title="No messages"
    description="You don't have any messages yet."
  />
</template>
```

### Empty State with Actions

```vue
<template>
  <UEmpty
    icon="i-heroicons-folder-open"
    title="No projects"
    description="Get started by creating your first project."
    :actions="[{
      label: 'Create Project',
      icon: 'i-heroicons-plus',
      click: () => createProject()
    }, {
      label: 'Import Project',
      variant: 'ghost',
      click: () => importProject()
    }]"
  />
</template>
```

### Empty State Variants

```vue
<template>
  <div class="grid grid-cols-2 gap-4">
    <UEmpty variant="solid" title="Solid" />
    <UEmpty variant="outline" title="Outline" />
    <UEmpty variant="soft" title="Soft" />
    <UEmpty variant="subtle" title="Subtle" />
  </div>
</template>
```

### Empty State with Avatar

```vue
<template>
  <UEmpty
    :avatar="{ src: '/robot.png' }"
    title="No activity"
    description="There's no recent activity to show."
  />
</template>
```

### Empty State with Custom Slots

```vue
<template>
  <UEmpty>
    <template #header>
      <div class="flex justify-center mb-4">
        <UIcon name="i-heroicons-magnifying-glass" class="w-16 h-16 text-gray-400" />
      </div>
    </template>

    <template #title>
      <h3 class="text-xl font-bold text-gray-900 dark:text-white">
        No results found
      </h3>
    </template>

    <template #description>
      <p class="text-gray-500 dark:text-gray-400">
        Try adjusting your search or filter criteria
      </p>
    </template>

    <template #actions>
      <div class="flex gap-2 mt-4">
        <UButton @click="clearFilters">Clear Filters</UButton>
        <UButton variant="ghost" @click="resetSearch">Reset Search</UButton>
      </div>
    </template>
  </UEmpty>
</template>
```

---

## Common Patterns

### Loading State Coordination

```vue
<template>
  <div>
    <!-- Show skeleton while loading -->
    <div v-if="loading" class="space-y-4">
      <USkeleton class="h-64 w-full" />
    </div>

    <!-- Show empty state if no data -->
    <UEmpty
      v-else-if="!items.length"
      icon="i-heroicons-inbox"
      title="No items"
      description="Start by adding your first item."
      :actions="[{ label: 'Add Item', click: openAddModal }]"
    />

    <!-- Show actual content -->
    <div v-else>
      <UCard v-for="item in items" :key="item.id">
        {{ item.name }}
      </UCard>
    </div>
  </div>
</template>
```

### Progress with Toast Updates

```vue
<script setup lang="ts">
const { add: addToast, remove } = useToast()
const uploadProgress = ref(0)

async function uploadFile(file: File) {
  const toastId = addToast({
    title: 'Uploading...',
    timeout: 0
  })

  try {
    await uploadWithProgress(file, (progress) => {
      uploadProgress.value = progress
    })

    remove(toastId)
    addToast({
      title: 'Upload complete!',
      color: 'success'
    })
  } catch (error) {
    remove(toastId)
    addToast({
      title: 'Upload failed',
      description: error.message,
      color: 'error'
    })
  }
}
</script>

<template>
  <div v-if="uploadProgress > 0 && uploadProgress < 100">
    <UProgress :value="uploadProgress" />
  </div>
</template>
```

---

## Reference

- **Templates**: See `templates/components/ui-toast-notifications.vue`, `ui-feedback-states.vue`, `ui-empty-state.vue`
- **Composables**: See `composables-guide.md` for useToast, useNotification
- **Loading Patterns**: See `loading-feedback-patterns.md`
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