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

View on GitHub
# Content Components Reference

Nuxt UI v4 provides components for documentation sites and blogs.

## Component Overview

| Component | Purpose |
|-----------|---------|
| BlogPost | Article display |
| BlogPosts | Blog grid |
| ChangelogVersion | Version entry |
| ChangelogVersions | Version timeline |
| ContentNavigation | Doc navigation |
| ContentSearch | Doc search |
| ContentSearchButton | Search button |
| ContentSurround | Prev/next links |
| ContentToc | Table of contents |

## Blog Components

### BlogPost

Individual blog post display.

```ts
interface BlogPostProps {
  title: string
  description?: string
  date?: string | Date
  image?: string
  badge?: BadgeProps
  authors?: Author[]
  to?: string
  orientation?: 'horizontal' | 'vertical'
}

interface Author {
  name: string
  avatar?: string
  to?: string
}
```

```vue
<UBlogPost
  title="Introducing Nuxt UI v4"
  description="The biggest update yet with 125+ components"
  date="2024-11-15"
  image="/blog/nuxt-ui-v4.png"
  :badge="{ label: 'Release', color: 'primary' }"
  :authors="[
    { name: 'John Doe', avatar: '/avatars/john.jpg' }
  ]"
  to="/blog/nuxt-ui-v4"
/>
```

### BlogPosts

Grid layout for blog posts.

```vue
<script setup>
const posts = await queryContent('/blog').find()
</script>

<template>
  <UBlogPosts>
    <UBlogPost
      v-for="post in posts"
      :key="post._path"
      :title="post.title"
      :description="post.description"
      :date="post.date"
      :image="post.image"
      :authors="post.authors"
      :to="post._path"
    />
  </UBlogPosts>
</template>
```

## Changelog Components

### ChangelogVersion

Single version entry.

```ts
interface ChangelogVersionProps {
  title: string
  date?: string | Date
  icon?: string
  badge?: BadgeProps
  to?: string
}
```

```vue
<UChangelogVersion
  title="v4.2.0"
  date="2024-11-20"
  icon="i-heroicons-rocket-launch"
  :badge="{ label: 'Latest', color: 'success' }"
>
  <h3>New Features</h3>
  <ul>
    <li>InputDate component</li>
    <li>InputTime component</li>
    <li>Empty state component</li>
  </ul>

  <h3>Bug Fixes</h3>
  <ul>
    <li>Fixed modal focus trap</li>
    <li>Fixed table virtualization</li>
  </ul>
</UChangelogVersion>
```

### ChangelogVersions

Timeline of versions.

```vue
<script setup>
const versions = [
  {
    title: 'v4.2.0',
    date: '2024-11-20',
    badge: { label: 'Latest', color: 'success' },
    content: '...'
  },
  {
    title: 'v4.1.0',
    date: '2024-10-15',
    content: '...'
  }
]
</script>

<template>
  <UChangelogVersions>
    <UChangelogVersion
      v-for="version in versions"
      :key="version.title"
      v-bind="version"
    >
      <MDC :value="version.content" />
    </UChangelogVersion>
  </UChangelogVersions>
</template>
```

## Documentation Components

### ContentNavigation

Accordion-style documentation navigation.

```ts
interface ContentNavigationProps {
  items: NavigationItem[]
  defaultOpen?: boolean
  multiple?: boolean          // Allow multiple open
}

interface NavigationItem {
  label: string
  icon?: string
  to?: string
  children?: NavigationItem[]
  defaultOpen?: boolean
}
```

```vue
<script setup>
const navigation = [
  {
    label: 'Getting Started',
    icon: 'i-heroicons-home',
    defaultOpen: true,
    children: [
      { label: 'Introduction', to: '/docs' },
      { label: 'Installation', to: '/docs/installation' },
      { label: 'Configuration', to: '/docs/configuration' }
    ]
  },
  {
    label: 'Components',
    icon: 'i-heroicons-cube',
    children: [
      { label: 'Button', to: '/docs/components/button' },
      { label: 'Card', to: '/docs/components/card' }
    ]
  }
]
</script>

<template>
  <UContentNavigation :items="navigation" />
</template>
```

### ContentSearch

CommandPalette for documentation search.

```vue
<script setup>
const searchGroups = computed(() => [
  {
    key: 'pages',
    label: 'Pages',
    commands: pages.value.map(page => ({
      id: page._path,
      label: page.title,
      to: page._path
    }))
  }
])
</script>

<template>
  <UContentSearch :groups="searchGroups" />
</template>
```

### ContentSearchButton

Button to trigger search.

```vue
<UContentSearchButton />

<!-- With custom styling -->
<UContentSearchButton class="w-full">
  <template #default>
    <span>Search documentation...</span>
    <UKbd>⌘K</UKbd>
  </template>
</UContentSearchButton>
```

### ContentToc

Sticky table of contents with active link highlighting.

```ts
interface ContentTocProps {
  links: TocLink[]
  title?: string
}

interface TocLink {
  id: string
  text: string
  depth: number
  children?: TocLink[]
}
```

```vue
<script setup>
// With @nuxt/content
const { data: page } = await useAsyncData('page', () => {
  return queryContent(route.path).findOne()
})
</script>

<template>
  <UContentToc :links="page?.body?.toc?.links" title="On this page" />
</template>
```

### ContentSurround

Previous/next navigation links.

```vue
<script setup>
const { data: surround } = await useAsyncData('surround', () => {
  return queryContent()
    .only(['_path', 'title', 'description'])
    .findSurround(route.path)
})
</script>

<template>
  <UContentSurround :surround="surround" />
</template>
```

## Documentation Layout

Complete documentation page layout:

```vue
<!-- layouts/docs.vue -->
<template>
  <UPage>
    <template #left>
      <UPageAside>
        <UContentSearchButton class="mb-4" />
        <UContentNavigation :items="navigation" />
      </UPageAside>
    </template>

    <UPageBody>
      <UPageHeader
        :title="page?.title"
        :description="page?.description"
      />

      <slot />

      <UContentSurround :surround="surround" />
    </UPageBody>

    <template #right>
      <UPageAside>
        <UContentToc :links="page?.body?.toc?.links" />
      </UPageAside>
    </template>
  </UPage>

  <UContentSearch :groups="searchGroups" />
</template>
```

## Blog Layout

Complete blog index:

```vue
<!-- pages/blog/index.vue -->
<template>
  <UPage>
    <UPageHeader
      title="Blog"
      description="Latest news and updates"
    />

    <UBlogPosts>
      <UBlogPost
        v-for="post in posts"
        :key="post._path"
        v-bind="post"
        :to="post._path"
      />
    </UBlogPosts>

    <UPagination
      v-model="page"
      :total="total"
      :per-page="10"
    />
  </UPage>
</template>
```

## Theming

```ts
export default defineAppConfig({
  ui: {
    blogPost: {
      slots: {
        root: 'group flex flex-col',
        image: 'aspect-video rounded-lg overflow-hidden',
        body: 'flex-1 flex flex-col',
        title: 'text-xl font-semibold group-hover:text-primary',
        description: 'text-muted mt-2'
      }
    },
    contentNavigation: {
      slots: {
        root: 'space-y-1',
        item: 'flex items-center gap-2 px-3 py-2 rounded-lg',
        itemActive: 'bg-primary/10 text-primary'
      }
    },
    contentToc: {
      slots: {
        root: 'space-y-2',
        link: 'block text-sm text-muted hover:text-default',
        linkActive: 'text-primary font-medium'
      }
    }
  }
})
```

## Nuxt Content Integration

```ts
// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxt/ui', '@nuxt/content'],

  content: {
    highlight: {
      theme: 'github-dark'
    }
  }
})
```

With `@nuxt/content`, you get automatic:
- Markdown processing with MDC
- Syntax highlighting
- Table of contents generation
- Navigation from file structure
- Search indexing
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