create-wervt 0.2.14 → 0.2.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/index.js +2 -0
- package/package.json +2 -2
- package/template/.claude/skills/nuxt-ui/SKILL.md +85 -243
- package/template/.claude/skills/nuxt-ui/references/components.md +184 -313
- package/template/.claude/skills/nuxt-ui/references/guidelines/component-selection.md +124 -0
- package/template/.claude/skills/nuxt-ui/references/guidelines/conventions.md +372 -0
- package/template/.claude/skills/nuxt-ui/references/guidelines/design-system.md +378 -0
- package/template/.claude/skills/nuxt-ui/references/guidelines/forms.md +235 -0
- package/template/.claude/skills/nuxt-ui/references/layouts/chat.md +140 -77
- package/template/.claude/skills/nuxt-ui/references/layouts/dashboard.md +33 -19
- package/template/.claude/skills/nuxt-ui/references/layouts/docs.md +23 -12
- package/template/.claude/skills/nuxt-ui/references/layouts/editor.md +49 -63
- package/template/.claude/skills/nuxt-ui/references/layouts/{page.md → landing.md} +43 -118
- package/template/.claude/skills/nuxt-ui/references/recipes/auth.md +162 -0
- package/template/.claude/skills/nuxt-ui/references/recipes/data-tables.md +249 -0
- package/template/.claude/skills/nuxt-ui/references/recipes/navigation.md +90 -0
- package/template/.claude/skills/nuxt-ui/references/recipes/overlays.md +177 -0
- package/template/.claude/skills/nuxt-ui-mobile/SKILL.md +38 -10
- package/template/.claude/skills/nuxt-ui-mobile/references/identity.md +127 -0
- package/template/.claude/skills/nuxt-ui-mobile/references/patterns.md +1 -0
- package/template/.claude/skills/nuxt-ui-mobile/references/review-checklist.md +14 -6
- package/template/.claude/skills/nuxt-ui-mobile/references/tokens.md +1 -1
- package/template/.claude/skills/nuxt-ui-mobile/template/app/assets/css/main.css +9 -9
- package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/ListSection.vue +7 -3
- package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/NavBar.vue +13 -4
- package/template/.claude/skills/nuxt-ui-mobile/template/nuxt.config.ts +2 -1
- package/template/AGENTS.md +175 -9
- package/template/drizzle/20261005212059_sudden_titania/snapshot.json +46 -25
- package/template/golar.config.ts +5 -0
- package/template/nuxt.config.ts +7 -0
- package/template/package.json +9 -6
- package/template/pnpm-workspace.yaml +2 -0
- package/template/server/api/example-secret.get.ts +8 -0
- package/template/.claude/skills/nuxt-ui/references/composables.md +0 -127
- package/template/.claude/skills/nuxt-ui/references/theming.md +0 -427
|
@@ -1,377 +1,248 @@
|
|
|
1
1
|
# Components
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Quick-reference index of all 125+ components. For full API docs (props, slots, events, examples), use the MCP `get-component` or `get-component-metadata` tools.
|
|
4
4
|
|
|
5
5
|
## Layout
|
|
6
6
|
|
|
7
|
-
Core structural components for organizing your application's layout.
|
|
8
|
-
|
|
9
7
|
| Component | Purpose |
|
|
10
8
|
|---|---|
|
|
11
|
-
| `UApp` | **Required** root wrapper
|
|
12
|
-
| `UHeader` | Responsive header with mobile menu
|
|
13
|
-
| `UFooter` | Footer
|
|
9
|
+
| `UApp` | **Required** root wrapper — toasts, tooltips, overlays, i18n |
|
|
10
|
+
| `UHeader` | Responsive header with mobile menu |
|
|
11
|
+
| `UFooter` | Footer with left/right/top/bottom slots |
|
|
14
12
|
| `UFooterColumns` | Multi-column footer with link groups |
|
|
15
|
-
| `UMain` | Main content area
|
|
16
|
-
| `UContainer` | Centered max-width container
|
|
13
|
+
| `UMain` | Main content area |
|
|
14
|
+
| `UContainer` | Centered max-width container |
|
|
15
|
+
| `USplitter` | Resizable panels separated by draggable handles |
|
|
16
|
+
| `ULink` | Enhanced link — NuxtLink/RouterLink with active states |
|
|
17
17
|
|
|
18
18
|
## Element
|
|
19
19
|
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
| Component | Key props |
|
|
20
|
+
| Component | Purpose |
|
|
23
21
|
|---|---|
|
|
24
|
-
| `UButton` |
|
|
25
|
-
| `UBadge` |
|
|
26
|
-
| `UAvatar` |
|
|
27
|
-
| `UAvatarGroup` |
|
|
28
|
-
| `UIcon` | `name
|
|
29
|
-
| `UCard` |
|
|
30
|
-
| `UAlert` |
|
|
31
|
-
| `UBanner` |
|
|
32
|
-
| `UChip` |
|
|
33
|
-
| `UKbd` |
|
|
34
|
-
| `USeparator` |
|
|
35
|
-
| `USkeleton` |
|
|
36
|
-
| `UProgress` |
|
|
37
|
-
| `
|
|
38
|
-
| `
|
|
39
|
-
| `
|
|
22
|
+
| `UButton` | Buttons — links, actions, icons, loading states |
|
|
23
|
+
| `UBadge` | Labels, tags, status indicators |
|
|
24
|
+
| `UAvatar` | User photos, initials, icons |
|
|
25
|
+
| `UAvatarGroup` | Stacked avatars with `max` limit |
|
|
26
|
+
| `UIcon` | Iconify icons (`i-{collection}-{name}`) |
|
|
27
|
+
| `UCard` | Bordered container with header/body/footer |
|
|
28
|
+
| `UAlert` | Inline messages — info, warning, error, success |
|
|
29
|
+
| `UBanner` | App-wide sticky announcement bar |
|
|
30
|
+
| `UChip` | Notification dot overlay on children |
|
|
31
|
+
| `UKbd` | Keyboard key display |
|
|
32
|
+
| `USeparator` | Divider line with optional label |
|
|
33
|
+
| `USkeleton` | Loading placeholder |
|
|
34
|
+
| `UProgress` | Progress bar |
|
|
35
|
+
| `UProgressGroup` | Segmented progress bar with a list of items |
|
|
36
|
+
| `UToast` | Toast notification (shown via `useToast`) |
|
|
37
|
+
| `UCalendar` | Date calendar (single, range, multiple) |
|
|
38
|
+
| `UCollapsible` | Animated expand/collapse |
|
|
39
|
+
| `UFieldGroup` | Group form inputs horizontally |
|
|
40
|
+
| `UMarquee` | Scrolling content ticker |
|
|
41
|
+
| `UCarousel` | Image/content carousel with autoplay |
|
|
42
|
+
| `UEmpty` | Empty state placeholder with icon, title, actions |
|
|
43
|
+
| `UError` | Error display with retry action |
|
|
44
|
+
| `UScrollArea` | Scrollable area with custom scrollbar |
|
|
45
|
+
| `UTimeline` | Timeline display for events and activity |
|
|
46
|
+
| `UUser` | User display — avatar + name + description |
|
|
47
|
+
| `UTheme` | Scoped `ui` class overrides and prop defaults for a subtree |
|
|
40
48
|
|
|
41
49
|
## Form
|
|
42
50
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
| Component | Key props |
|
|
51
|
+
| Component | Purpose |
|
|
46
52
|
|---|---|
|
|
47
|
-
| `
|
|
48
|
-
| `
|
|
49
|
-
| `
|
|
50
|
-
| `
|
|
51
|
-
| `
|
|
52
|
-
| `
|
|
53
|
-
| `
|
|
54
|
-
| `
|
|
55
|
-
| `
|
|
56
|
-
| `
|
|
57
|
-
| `
|
|
58
|
-
| `
|
|
59
|
-
| `
|
|
60
|
-
| `
|
|
61
|
-
| `
|
|
62
|
-
| `
|
|
63
|
-
| `
|
|
64
|
-
| `
|
|
65
|
-
| `
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
```vue
|
|
72
|
-
<script setup lang="ts">
|
|
73
|
-
import { z } from 'zod'
|
|
74
|
-
|
|
75
|
-
const schema = z.object({
|
|
76
|
-
email: z.string().email('Invalid email'),
|
|
77
|
-
password: z.string().min(8, 'Min 8 characters')
|
|
78
|
-
})
|
|
79
|
-
|
|
80
|
-
type Schema = z.output<typeof schema>
|
|
81
|
-
const state = reactive<Partial<Schema>>({ email: '', password: '' })
|
|
82
|
-
const form = ref()
|
|
83
|
-
|
|
84
|
-
async function onSubmit() {
|
|
85
|
-
await form.value.validate()
|
|
86
|
-
}
|
|
87
|
-
</script>
|
|
88
|
-
|
|
89
|
-
<template>
|
|
90
|
-
<UForm ref="form" :schema="schema" :state="state" @submit="onSubmit">
|
|
91
|
-
<UFormField name="email" label="Email" required>
|
|
92
|
-
<UInput v-model="state.email" type="email" />
|
|
93
|
-
</UFormField>
|
|
94
|
-
|
|
95
|
-
<UFormField name="password" label="Password" required>
|
|
96
|
-
<UInput v-model="state.password" type="password" />
|
|
97
|
-
</UFormField>
|
|
98
|
-
|
|
99
|
-
<UButton type="submit">Submit</UButton>
|
|
100
|
-
</UForm>
|
|
101
|
-
</template>
|
|
102
|
-
```
|
|
103
|
-
|
|
104
|
-
With Valibot:
|
|
105
|
-
|
|
106
|
-
```vue
|
|
107
|
-
<script setup lang="ts">
|
|
108
|
-
import * as v from 'valibot'
|
|
109
|
-
|
|
110
|
-
const schema = v.object({
|
|
111
|
-
email: v.pipe(v.string(), v.email('Invalid email')),
|
|
112
|
-
password: v.pipe(v.string(), v.minLength(8, 'Min 8 characters'))
|
|
113
|
-
})
|
|
114
|
-
</script>
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
### File upload
|
|
118
|
-
|
|
119
|
-
```vue
|
|
120
|
-
<script setup>
|
|
121
|
-
const files = ref<File[]>([])
|
|
122
|
-
</script>
|
|
123
|
-
|
|
124
|
-
<template>
|
|
125
|
-
<UFileUpload v-model="files" accept="image/*" multiple>
|
|
126
|
-
<template #actions="{ open }">
|
|
127
|
-
<UButton label="Upload" icon="i-lucide-upload" color="neutral" variant="outline" @click="open()" />
|
|
128
|
-
</template>
|
|
129
|
-
</UFileUpload>
|
|
130
|
-
</template>
|
|
131
|
-
```
|
|
53
|
+
| `UAuthForm` | Pre-built auth form with social providers |
|
|
54
|
+
| `UInput` | Text input — text, email, password, search |
|
|
55
|
+
| `UTextarea` | Multi-line text with autoresize |
|
|
56
|
+
| `USelect` | Native-like dropdown for small lists |
|
|
57
|
+
| `USelectMenu` | Rich searchable dropdown, multi-select, groups |
|
|
58
|
+
| `UInputMenu` | Autocomplete / combobox |
|
|
59
|
+
| `UInputNumber` | Numeric input with +/- controls |
|
|
60
|
+
| `UInputRating` | Rating input |
|
|
61
|
+
| `UInputDate` | Date picker with calendar |
|
|
62
|
+
| `UInputTime` | Time picker (12/24h) |
|
|
63
|
+
| `UInputTags` | Tag/chip input |
|
|
64
|
+
| `UListbox` | Selectable list with search and virtualization |
|
|
65
|
+
| `ULocaleSelect` | Select to switch between locales |
|
|
66
|
+
| `UPinInput` | Verification code input |
|
|
67
|
+
| `UCheckbox` | Single boolean checkbox |
|
|
68
|
+
| `UCheckboxGroup` | Multiple checkboxes |
|
|
69
|
+
| `URadioGroup` | Radio button group |
|
|
70
|
+
| `USwitch` | Toggle switch |
|
|
71
|
+
| `USlider` | Range slider |
|
|
72
|
+
| `UColorPicker` | Color picker (hex/rgb/hsl) |
|
|
73
|
+
| `UFileUpload` | File upload (button or drop area) |
|
|
74
|
+
| `UForm` | Validation wrapper with Standard Schema |
|
|
75
|
+
| `UFormField` | Field wrapper with label, hint, errors |
|
|
132
76
|
|
|
133
|
-
##
|
|
134
|
-
|
|
135
|
-
Components for displaying and organizing data.
|
|
77
|
+
## Overlay
|
|
136
78
|
|
|
137
|
-
| Component |
|
|
79
|
+
| Component | Purpose |
|
|
138
80
|
|---|---|
|
|
139
|
-
| `
|
|
140
|
-
| `
|
|
141
|
-
| `
|
|
142
|
-
| `
|
|
143
|
-
| `
|
|
144
|
-
| `
|
|
145
|
-
| `
|
|
146
|
-
| `UMarquee` | `repeat`, `reverse`, `orientation`, `pauseOnHover` — infinite scroll |
|
|
147
|
-
| `UScrollArea` | Custom scrollbar wrapper |
|
|
81
|
+
| `UModal` | Centered dialog — confirmations, forms |
|
|
82
|
+
| `USlideover` | Side panel — details, editing |
|
|
83
|
+
| `UDrawer` | Bottom sheet — mobile actions |
|
|
84
|
+
| `UPopover` | Contextual popup attached to trigger |
|
|
85
|
+
| `UTooltip` | Hover/focus hint (non-interactive) |
|
|
86
|
+
| `UContextMenu` | Right-click menu |
|
|
87
|
+
| `UCommandPalette` | Search + keyboard navigation (Cmd+K) |
|
|
148
88
|
|
|
149
89
|
## Navigation
|
|
150
90
|
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
| Component | Key props |
|
|
91
|
+
| Component | Purpose |
|
|
154
92
|
|---|---|
|
|
155
|
-
| `
|
|
156
|
-
| `
|
|
157
|
-
| `UTabs` |
|
|
158
|
-
| `
|
|
159
|
-
| `
|
|
160
|
-
| `
|
|
161
|
-
| `
|
|
93
|
+
| `USidebar` | Standalone sidebar with header/body/footer |
|
|
94
|
+
| `UNavigationMenu` | Primary nav — horizontal or vertical |
|
|
95
|
+
| `UTabs` | Tab switcher within a page |
|
|
96
|
+
| `UBreadcrumb` | Location hierarchy |
|
|
97
|
+
| `UDropdownMenu` | Action menu on a trigger |
|
|
98
|
+
| `UPagination` | Page navigation |
|
|
99
|
+
| `UStepper` | Multi-step wizard |
|
|
100
|
+
| `UAccordion` | Collapsible sections |
|
|
162
101
|
|
|
163
|
-
##
|
|
164
|
-
|
|
165
|
-
Floating UI elements that appear above the main content. **All require `<UApp>` wrapper.**
|
|
102
|
+
## Data
|
|
166
103
|
|
|
167
|
-
| Component |
|
|
104
|
+
| Component | Purpose |
|
|
168
105
|
|---|---|
|
|
169
|
-
| `
|
|
170
|
-
| `
|
|
171
|
-
| `UDrawer` | `v-model:open`, `title`, `handle` |
|
|
172
|
-
| `UPopover` | `arrow`, `content: { side, align }`, `openDelay`, `closeDelay` |
|
|
173
|
-
| `UTooltip` | `text`, `content: { side }`, `delayDuration` |
|
|
174
|
-
| `UDropdownMenu` | `items` (flat `T[]` or grouped `T[][]` with separators, supports nested `children`) |
|
|
175
|
-
| `UContextMenu` | `items` (flat `T[]` or grouped `T[][]`) — right-click menu |
|
|
176
|
-
| `UToast` | Used via `useToast()` composable |
|
|
177
|
-
|
|
178
|
-
### Modal
|
|
179
|
-
|
|
180
|
-
```vue
|
|
181
|
-
<UModal v-model:open="isOpen" title="Edit" description="Edit your profile">
|
|
182
|
-
<template #body>Content</template>
|
|
183
|
-
<template #footer>
|
|
184
|
-
<UButton variant="ghost" @click="isOpen = false">Cancel</UButton>
|
|
185
|
-
<UButton @click="save">Save</UButton>
|
|
186
|
-
</template>
|
|
187
|
-
</UModal>
|
|
188
|
-
```
|
|
189
|
-
|
|
190
|
-
Slots: `#content`, `#header`, `#body`, `#footer`
|
|
191
|
-
|
|
192
|
-
### Slideover
|
|
193
|
-
|
|
194
|
-
```vue
|
|
195
|
-
<USlideover v-model:open="isOpen" title="Settings" side="right">
|
|
196
|
-
<template #body>Content</template>
|
|
197
|
-
</USlideover>
|
|
198
|
-
```
|
|
199
|
-
|
|
200
|
-
### Drawer
|
|
201
|
-
|
|
202
|
-
```vue
|
|
203
|
-
<UDrawer v-model:open="isOpen" title="Options" handle>
|
|
204
|
-
<template #body>Content</template>
|
|
205
|
-
</UDrawer>
|
|
206
|
-
```
|
|
207
|
-
|
|
208
|
-
### DropdownMenu
|
|
209
|
-
|
|
210
|
-
Items accept a flat array or a nested array (each sub-array is rendered as a group separated by dividers):
|
|
211
|
-
|
|
212
|
-
```vue
|
|
213
|
-
<!-- Flat array -->
|
|
214
|
-
<UDropdownMenu :items="[
|
|
215
|
-
{ label: 'Edit', icon: 'i-lucide-pencil', onSelect: () => edit() },
|
|
216
|
-
{ type: 'separator' },
|
|
217
|
-
{ label: 'Delete', icon: 'i-lucide-trash', color: 'error' }
|
|
218
|
-
]">
|
|
219
|
-
<UButton icon="i-lucide-ellipsis-vertical" variant="ghost" />
|
|
220
|
-
</UDropdownMenu>
|
|
221
|
-
|
|
222
|
-
<!-- Nested array (groups with automatic separators) -->
|
|
223
|
-
<UDropdownMenu :items="[
|
|
224
|
-
[{ label: 'Edit', icon: 'i-lucide-pencil' }, { label: 'Duplicate', icon: 'i-lucide-copy' }],
|
|
225
|
-
[{ label: 'Delete', icon: 'i-lucide-trash', color: 'error' }]
|
|
226
|
-
]">
|
|
227
|
-
<UButton icon="i-lucide-ellipsis-vertical" variant="ghost" />
|
|
228
|
-
</UDropdownMenu>
|
|
229
|
-
```
|
|
230
|
-
|
|
231
|
-
### Toast
|
|
232
|
-
|
|
233
|
-
```ts
|
|
234
|
-
const toast = useToast()
|
|
235
|
-
|
|
236
|
-
toast.add({
|
|
237
|
-
title: 'Success',
|
|
238
|
-
description: 'Changes saved',
|
|
239
|
-
color: 'success',
|
|
240
|
-
icon: 'i-lucide-check-circle',
|
|
241
|
-
duration: 5000,
|
|
242
|
-
actions: [{ label: 'Undo', onClick: () => undo() }]
|
|
243
|
-
})
|
|
244
|
-
```
|
|
245
|
-
|
|
246
|
-
### Programmatic overlays
|
|
247
|
-
|
|
248
|
-
```ts
|
|
249
|
-
const overlay = useOverlay()
|
|
250
|
-
|
|
251
|
-
// create() returns a reusable instance
|
|
252
|
-
const confirmDialog = overlay.create(ConfirmDialog)
|
|
253
|
-
|
|
254
|
-
// open() returns an object with .result (a Promise)
|
|
255
|
-
const { result } = confirmDialog.open({
|
|
256
|
-
title: 'Delete?',
|
|
257
|
-
message: 'This cannot be undone.'
|
|
258
|
-
})
|
|
259
|
-
|
|
260
|
-
if (await result) {
|
|
261
|
-
// User confirmed
|
|
262
|
-
}
|
|
263
|
-
|
|
264
|
-
// Inside the overlay component, emit close with a value:
|
|
265
|
-
// emit('close', true) or emit('close', false)
|
|
266
|
-
```
|
|
267
|
-
|
|
268
|
-
### CommandPalette
|
|
269
|
-
|
|
270
|
-
```vue
|
|
271
|
-
<script setup>
|
|
272
|
-
const groups = [{
|
|
273
|
-
id: 'actions',
|
|
274
|
-
label: 'Actions',
|
|
275
|
-
items: [
|
|
276
|
-
{ label: 'New file', icon: 'i-lucide-file-plus', onSelect: () => {} },
|
|
277
|
-
{ label: 'Settings', to: '/settings' }
|
|
278
|
-
]
|
|
279
|
-
}]
|
|
280
|
-
|
|
281
|
-
defineShortcuts({ meta_k: () => { isOpen.value = true } })
|
|
282
|
-
</script>
|
|
283
|
-
|
|
284
|
-
<UCommandPalette v-model:open="isOpen" :groups="groups" placeholder="Search..." />
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
## Page
|
|
106
|
+
| `UTable` | Data table (TanStack Table) with sorting, selection, pinning |
|
|
107
|
+
| `UTree` | Hierarchical tree view |
|
|
288
108
|
|
|
289
|
-
|
|
109
|
+
## Dashboard
|
|
290
110
|
|
|
291
111
|
| Component | Purpose |
|
|
292
112
|
|---|---|
|
|
293
|
-
| `
|
|
294
|
-
| `
|
|
295
|
-
| `
|
|
296
|
-
| `
|
|
113
|
+
| `UDashboardGroup` | Root dashboard wrapper |
|
|
114
|
+
| `UDashboardSidebar` | Resizable, collapsible sidebar |
|
|
115
|
+
| `UDashboardPanel` | Content panel with header/body/footer |
|
|
116
|
+
| `UDashboardNavbar` | Panel header bar |
|
|
117
|
+
| `UDashboardToolbar` | Filter/action bar below navbar |
|
|
118
|
+
| `UDashboardResizeHandle` | Resize handle between panels |
|
|
119
|
+
| `UDashboardSidebarToggle` | Mobile sidebar toggle button |
|
|
120
|
+
| `UDashboardSearchButton` | Search button for sidebar |
|
|
121
|
+
| `UDashboardSearch` | Dashboard-level search overlay |
|
|
122
|
+
| `UDashboardSidebarCollapse` | Collapse button for sidebar |
|
|
123
|
+
|
|
124
|
+
## Page (marketing)
|
|
125
|
+
|
|
126
|
+
| Component | Purpose |
|
|
127
|
+
|---|---|
|
|
128
|
+
| `UPage` | Multi-column layout with left/right sidebars |
|
|
129
|
+
| `UPageHero` | Hero section — title, description, links, media |
|
|
130
|
+
| `UPageSection` | Content section with features grid |
|
|
297
131
|
| `UPageCTA` | Call to action block |
|
|
298
132
|
| `UPageHeader` | Page title and description |
|
|
299
|
-
| `UPageBody` | Main content area
|
|
300
|
-
| `
|
|
301
|
-
| `UPageGrid` | Grid layout for cards |
|
|
133
|
+
| `UPageBody` | Main content area |
|
|
134
|
+
| `UPageGrid` | Card grid layout |
|
|
302
135
|
| `UPageColumns` | Multi-column layout |
|
|
303
136
|
| `UPageCard` | Content card for grids |
|
|
304
|
-
| `
|
|
305
|
-
| `
|
|
137
|
+
| `UPageFeature` | Feature item |
|
|
138
|
+
| `UPageLogos` | Logo cloud |
|
|
139
|
+
| `UPageAside` | Sticky sidebar wrapper |
|
|
140
|
+
| `UPageAnchors` | Simple anchor links |
|
|
306
141
|
| `UPageLinks` | Related resource links |
|
|
307
|
-
| `UPageList` | List items |
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
142
|
+
| `UPageList` | List layout for page items |
|
|
143
|
+
|
|
144
|
+
## Blog & Changelog
|
|
145
|
+
|
|
146
|
+
| Component | Purpose |
|
|
147
|
+
|---|---|
|
|
148
|
+
| `UBlogPosts` | Blog post grid |
|
|
149
|
+
| `UBlogPost` | Individual post card |
|
|
150
|
+
| `UChangelogVersions` | Changelog list |
|
|
311
151
|
| `UChangelogVersion` | Individual changelog entry |
|
|
152
|
+
|
|
153
|
+
## Pricing
|
|
154
|
+
|
|
155
|
+
| Component | Purpose |
|
|
156
|
+
|---|---|
|
|
312
157
|
| `UPricingPlans` | Pricing plan cards |
|
|
158
|
+
| `UPricingPlan` | Individual pricing plan card |
|
|
313
159
|
| `UPricingTable` | Feature comparison table |
|
|
314
160
|
|
|
315
|
-
##
|
|
161
|
+
## Prose — Base Typography
|
|
316
162
|
|
|
317
|
-
|
|
163
|
+
Standard Markdown elements auto-resolved by Comark/Content/MDC. No `::` prefix needed — they map directly from markdown syntax (`# Heading` → `ProseH1`, `**bold**` → `ProseStrong`, etc.). Themed via `appConfig.ui.prose.<name>`.
|
|
164
|
+
|
|
165
|
+
| Component | Renders | Notable |
|
|
166
|
+
|---|---|---|
|
|
167
|
+
| `H1` `H2` `H3` `H4` | Headings | H1–H3 get anchor links + TOC entries |
|
|
168
|
+
| `P` | Paragraph | |
|
|
169
|
+
| `A` | Link | External links get target/rel handling |
|
|
170
|
+
| `Strong` | Bold | |
|
|
171
|
+
| `Em` | Italic | |
|
|
172
|
+
| `Blockquote` | Blockquote | |
|
|
173
|
+
| `Hr` | Horizontal rule | |
|
|
174
|
+
| `Ul` `Ol` `Li` | Lists | Supports nesting and mixed lists |
|
|
175
|
+
| `Table` `Thead` `Tbody` `Tr` `Th` `Td` | Tables | |
|
|
176
|
+
| `Img` | Image | Zoom on click (`:zoom="false"` to disable), `@nuxt/image` support |
|
|
177
|
+
| `Pre` | Code block | Copy button, filename + icon, line highlighting (`{2,4-6}`), diff |
|
|
178
|
+
| `Code` | Inline code | `color` and `lang` props |
|
|
179
|
+
|
|
180
|
+
## Prose — Feature Components
|
|
181
|
+
|
|
182
|
+
Nuxt UI-specific Prose components. In markdown files they are used **without the `Prose` prefix** (e.g. `::callout`, `::steps`). In Vue they are referenced as `ProseCallout`, `ProseSteps`, etc. Comark resolves them automatically when `@nuxt/ui` is installed.
|
|
183
|
+
|
|
184
|
+
Nuxt UI also registers shorthand aliases for `Callout`: `::note`, `::tip`, `::warning`, `::caution` (preset `color` + `icon`).
|
|
318
185
|
|
|
319
186
|
| Component | Purpose |
|
|
320
187
|
|---|---|
|
|
321
|
-
| `
|
|
322
|
-
| `
|
|
323
|
-
| `
|
|
324
|
-
| `
|
|
325
|
-
| `
|
|
326
|
-
| `
|
|
327
|
-
| `
|
|
328
|
-
| `
|
|
329
|
-
| `
|
|
330
|
-
| `
|
|
188
|
+
| `Callout` | Highlighted note/warning/tip (`color`, `icon`, `to`) |
|
|
189
|
+
| `Badge` | Inline badge/tag |
|
|
190
|
+
| `Kbd` | Keyboard key |
|
|
191
|
+
| `Icon` | Inline Iconify icon |
|
|
192
|
+
| `Prompt` | Terminal prompt block |
|
|
193
|
+
| `Card` `CardGroup` | Content card and card grid |
|
|
194
|
+
| `Steps` | Numbered step list (`level` prop sets heading depth) |
|
|
195
|
+
| `Tabs` `TabsItem` | Tabbed content (`sync` for localStorage, `hash` for scroll-on-change) |
|
|
196
|
+
| `Accordion` `AccordionItem` | Collapsible accordion sections |
|
|
197
|
+
| `Collapsible` | Single collapsible section |
|
|
198
|
+
| `Field` `FieldGroup` | Form field display |
|
|
199
|
+
| `CodeGroup` | Tabbed code blocks |
|
|
200
|
+
| `CodeCollapse` | Collapsible code block |
|
|
201
|
+
| `CodeIcon` | File-type icon in code headers |
|
|
202
|
+
| `CodePreview` | Code + live rendered preview side by side |
|
|
203
|
+
| `CodeTree` | File tree display |
|
|
204
|
+
| `Script` | Script injection |
|
|
205
|
+
|
|
206
|
+
## Content (Nuxt Content)
|
|
331
207
|
|
|
332
|
-
|
|
208
|
+
| Component | Purpose |
|
|
209
|
+
|---|---|
|
|
210
|
+
| `UContentNavigation` | Sidebar navigation from content |
|
|
211
|
+
| `UContentToc` | Table of contents |
|
|
212
|
+
| `UContentSurround` | Prev/next navigation |
|
|
213
|
+
| `UContentSearch` | Search command palette |
|
|
214
|
+
| `UContentSearchButton` | Trigger for content search |
|
|
333
215
|
|
|
334
|
-
|
|
216
|
+
## Chat (AI)
|
|
335
217
|
|
|
336
218
|
| Component | Purpose |
|
|
337
219
|
|---|---|
|
|
338
|
-
| `UChatMessages` | Scrollable message list
|
|
339
|
-
| `UChatMessage` | Individual message
|
|
220
|
+
| `UChatMessages` | Scrollable message list |
|
|
221
|
+
| `UChatMessage` | Individual message bubble |
|
|
222
|
+
| `UChatReasoning` | Collapsible AI reasoning block |
|
|
223
|
+
| `UChatTool` | Tool invocation status |
|
|
224
|
+
| `UChatShimmer` | Streaming text animation |
|
|
340
225
|
| `UChatPrompt` | Enhanced textarea for prompts |
|
|
341
|
-
| `UChatPromptSubmit` | Submit button with status
|
|
226
|
+
| `UChatPromptSubmit` | Submit button with status |
|
|
342
227
|
| `UChatPalette` | Chat layout for overlays |
|
|
343
228
|
|
|
344
229
|
## Editor
|
|
345
230
|
|
|
346
|
-
Rich text editor powered by [TipTap](https://tiptap.dev/).
|
|
347
|
-
|
|
348
231
|
| Component | Purpose |
|
|
349
232
|
|---|---|
|
|
350
|
-
| `UEditor` |
|
|
351
|
-
| `UEditorToolbar` | Toolbar (
|
|
233
|
+
| `UEditor` | Rich text editor (JSON/HTML/Markdown) |
|
|
234
|
+
| `UEditorToolbar` | Toolbar (fixed/bubble/floating) |
|
|
352
235
|
| `UEditorDragHandle` | Block drag-and-drop |
|
|
353
236
|
| `UEditorSuggestionMenu` | Slash command menu |
|
|
354
237
|
| `UEditorMentionMenu` | @ mention menu |
|
|
355
238
|
| `UEditorEmojiMenu` | Emoji picker |
|
|
356
239
|
|
|
357
|
-
## Content
|
|
358
|
-
|
|
359
|
-
Components integrating with `@nuxt/content`.
|
|
360
|
-
|
|
361
|
-
| Component | Purpose |
|
|
362
|
-
|---|---|
|
|
363
|
-
| `UContentNavigation` | Sidebar navigation tree |
|
|
364
|
-
| `UContentToc` | Table of contents |
|
|
365
|
-
| `UContentSurround` | Prev/next links |
|
|
366
|
-
| `UContentSearch` | Search command palette |
|
|
367
|
-
| `UContentSearchButton` | Search trigger button |
|
|
368
|
-
|
|
369
240
|
## Color Mode
|
|
370
241
|
|
|
371
242
|
| Component | Purpose |
|
|
372
243
|
|---|---|
|
|
373
|
-
| `UColorModeButton` | Toggle light/dark
|
|
374
|
-
| `UColorModeSwitch` | Toggle light/dark
|
|
375
|
-
| `UColorModeSelect` | Dropdown
|
|
376
|
-
| `UColorModeAvatar` | Avatar
|
|
377
|
-
| `UColorModeImage` | Image
|
|
244
|
+
| `UColorModeButton` | Toggle button (light/dark) |
|
|
245
|
+
| `UColorModeSwitch` | Toggle switch (light/dark) |
|
|
246
|
+
| `UColorModeSelect` | Dropdown (light/dark/system) |
|
|
247
|
+
| `UColorModeAvatar` | Avatar that changes with color mode |
|
|
248
|
+
| `UColorModeImage` | Image that changes with color mode |
|