create-wervt 0.2.15 → 0.2.17

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.
Files changed (33) hide show
  1. package/index.js +2 -0
  2. package/package.json +2 -2
  3. package/template/.claude/skills/nuxt-ui/SKILL.md +85 -243
  4. package/template/.claude/skills/nuxt-ui/references/components.md +184 -313
  5. package/template/.claude/skills/nuxt-ui/references/guidelines/component-selection.md +124 -0
  6. package/template/.claude/skills/nuxt-ui/references/guidelines/conventions.md +372 -0
  7. package/template/.claude/skills/nuxt-ui/references/guidelines/design-system.md +378 -0
  8. package/template/.claude/skills/nuxt-ui/references/guidelines/forms.md +235 -0
  9. package/template/.claude/skills/nuxt-ui/references/layouts/chat.md +140 -77
  10. package/template/.claude/skills/nuxt-ui/references/layouts/dashboard.md +33 -19
  11. package/template/.claude/skills/nuxt-ui/references/layouts/docs.md +23 -12
  12. package/template/.claude/skills/nuxt-ui/references/layouts/editor.md +49 -63
  13. package/template/.claude/skills/nuxt-ui/references/layouts/{page.md → landing.md} +43 -118
  14. package/template/.claude/skills/nuxt-ui/references/recipes/auth.md +162 -0
  15. package/template/.claude/skills/nuxt-ui/references/recipes/data-tables.md +249 -0
  16. package/template/.claude/skills/nuxt-ui/references/recipes/navigation.md +90 -0
  17. package/template/.claude/skills/nuxt-ui/references/recipes/overlays.md +177 -0
  18. package/template/.claude/skills/nuxt-ui-mobile/SKILL.md +38 -10
  19. package/template/.claude/skills/nuxt-ui-mobile/references/identity.md +127 -0
  20. package/template/.claude/skills/nuxt-ui-mobile/references/patterns.md +1 -0
  21. package/template/.claude/skills/nuxt-ui-mobile/references/review-checklist.md +14 -6
  22. package/template/.claude/skills/nuxt-ui-mobile/references/tokens.md +1 -1
  23. package/template/.claude/skills/nuxt-ui-mobile/template/app/assets/css/main.css +9 -9
  24. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/ListSection.vue +7 -3
  25. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/NavBar.vue +13 -4
  26. package/template/.claude/skills/nuxt-ui-mobile/template/nuxt.config.ts +2 -1
  27. package/template/.claude/skills/wervt-logs/SKILL.md +16 -13
  28. package/template/AGENTS.md +120 -8
  29. package/template/golar.config.ts +5 -0
  30. package/template/package.json +7 -4
  31. package/template/pnpm-workspace.yaml +2 -0
  32. package/template/.claude/skills/nuxt-ui/references/composables.md +0 -127
  33. package/template/.claude/skills/nuxt-ui/references/theming.md +0 -427
package/index.js CHANGED
@@ -27,6 +27,8 @@ const EXAMPLE_FILES = [
27
27
  'server/api/todos',
28
28
  'server/api/shapes/todos.get.ts',
29
29
  'server/tools',
30
+ // Seeds the example's todos; without the table it doesn't type-check.
31
+ 'server/tasks/db/seed.ts',
30
32
  'drizzle',
31
33
  ]
32
34
  const EMPTY_SCHEMA = `// Tables are declared without a schema: on wervt the app's database role only sees
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-wervt",
3
- "version": "0.2.15",
3
+ "version": "0.2.17",
4
4
  "description": "Create a new wervt app: Nuxt 5, Postgres with Drizzle, live data with Electric.",
5
5
  "homepage": "https://wervt.app",
6
6
  "license": "MIT",
@@ -23,7 +23,7 @@
23
23
  "@clack/prompts": "^1.8.1",
24
24
  "citty": "^0.2.2",
25
25
  "giget": "^3.3.1",
26
- "nypm": "^0.6.10"
26
+ "nypm": "^0.6.12"
27
27
  },
28
28
  "scripts": {}
29
29
  }
@@ -5,7 +5,87 @@ description: Build UIs with @nuxt/ui v4 — 125+ accessible Vue components with
5
5
 
6
6
  # Nuxt UI
7
7
 
8
- Vue component library built on [Reka UI](https://reka-ui.com/) + [Tailwind CSS](https://tailwindcss.com/) + [Tailwind Variants](https://www.tailwind-variants.org/). Works with Nuxt, Vue (Vite), Laravel (Inertia), and AdonisJS (Inertia).
8
+ Vue component library built on [Reka UI](https://reka-ui.com/) + [Tailwind CSS](https://tailwindcss.com/) + [Tailwind Variants](https://www.tailwind-variants.org/). Works with Nuxt, Vue (Vite), Laravel (Vite + Inertia), and AdonisJS (Vite + Inertia).
9
+
10
+ ## MCP Server
11
+
12
+ For component API details (props, slots, events, full documentation, examples), use the [Nuxt UI MCP server](https://ui.nuxt.com/docs/getting-started/ai/mcp). If not already configured, add it:
13
+
14
+ **Cursor** — `.cursor/mcp.json`:
15
+
16
+ ```json
17
+ { "mcpServers": { "nuxt-ui": { "type": "http", "url": "https://ui.nuxt.com/mcp" } } }
18
+ ```
19
+
20
+ **Claude Code**:
21
+
22
+ ```bash
23
+ claude mcp add --transport http nuxt-ui https://ui.nuxt.com/mcp
24
+ ```
25
+
26
+ Key MCP tools:
27
+ - `search-components` — find components by name, category, or intent (no params = list all)
28
+ - `search-composables` — find composables by name or description (no params = list all)
29
+ - `search-icons` — search Iconify icons (defaults to `lucide`), returns `i-{prefix}-{name}` names
30
+ - `get-component` — full component documentation with usage examples
31
+ - `get-component-metadata` — props, slots, events (lightweight, no docs content)
32
+ - `get-example` — real-world code examples
33
+
34
+ When you need to know **what a component accepts** or **how its API works**, use the MCP. This skill teaches you **when to use which component** and **how to build well**.
35
+
36
+ ## Core rules (always apply)
37
+
38
+ 1. **Always wrap the app in `UApp`** — required for toasts, tooltips, and programmatic overlays. Accepts a `locale` prop for i18n.
39
+ 2. **Always use semantic colors** — `text-default`, `bg-elevated`, `border-muted`, etc. Never use raw Tailwind palette colors like `text-gray-500`.
40
+ 3. **Read generated theme files for slot names** — Nuxt: `.nuxt/ui/<component>.ts`, Vue: `node_modules/.nuxt-ui/ui/<component>.ts`. These show every slot, variant, and default class for any component.
41
+ 4. **Override priority** (highest wins): `ui` prop / `class` prop → global config → theme defaults.
42
+ 5. **Icons use `i-{collection}-{name}` format** — `lucide` is the default collection. Use the MCP `search-icons` tool to find icons, or browse at [icones.js.org](https://icones.js.org).
43
+
44
+ ## How to use this skill
45
+
46
+ Based on the task, load the relevant reference files **before writing any code**. Don't load everything — only what's needed.
47
+
48
+ ### Reference files
49
+
50
+ **Guidelines** — design decisions and conventions:
51
+ - [design-system](references/guidelines/design-system.md) — semantic colors, theming, brand customization, variants, the `ui` prop
52
+ - [component-selection](references/guidelines/component-selection.md) — decision matrices: when to use Modal vs Slideover, Select vs SelectMenu, Toast vs Alert, etc.
53
+ - [conventions](references/guidelines/conventions.md) — coding patterns, slot naming, items arrays, composables, keyboard shortcuts
54
+ - [forms](references/guidelines/forms.md) — form validation, field layout, error handling, Standard Schema
55
+
56
+ **Layouts** — full page structure patterns:
57
+ - [landing](references/layouts/landing.md) — landing pages, blog, changelog, pricing
58
+ - [dashboard](references/layouts/dashboard.md) — admin UI with sidebar and panels
59
+ - [docs](references/layouts/docs.md) — documentation sites with navigation and TOC
60
+ - [chat](references/layouts/chat.md) — AI chat with Vercel AI SDK
61
+ - [editor](references/layouts/editor.md) — rich text editor with toolbars
62
+
63
+ **Recipes** — complete patterns for common tasks:
64
+ - [data-tables](references/recipes/data-tables.md) — tables with filters, pagination, sorting, selection
65
+ - [auth](references/recipes/auth.md) — login, signup, forgot password forms
66
+ - [overlays](references/recipes/overlays.md) — modals, slideovers, drawers, command palette
67
+ - [navigation](references/recipes/navigation.md) — headers, sidebars, breadcrumbs, tabs
68
+
69
+ **Quick reference:**
70
+ - [components](references/components.md) — categorized component index for finding the right component name
71
+
72
+ ### Routing table
73
+
74
+ | Task | Load these references |
75
+ |---|---|
76
+ | Build a landing page | design-system, conventions, landing |
77
+ | Build a dashboard / admin UI | conventions, component-selection, dashboard |
78
+ | Add a settings page | conventions, forms |
79
+ | Create a login / signup form | conventions, forms, auth |
80
+ | Display data in a table | conventions, component-selection, data-tables |
81
+ | Customize theme / brand colors | design-system |
82
+ | Add a chat interface | conventions, chat |
83
+ | Add a modal, slideover, or drawer | conventions, component-selection, overlays |
84
+ | Build site navigation | conventions, component-selection, navigation |
85
+ | Build a documentation site | conventions, docs |
86
+ | Render markdown | component-selection, components, docs |
87
+ | Add a rich text editor | conventions, editor |
88
+ | General UI work | conventions, component-selection |
9
89
 
10
90
  ## Installation
11
91
 
@@ -60,14 +140,13 @@ export default defineConfig({
60
140
 
61
141
  ```ts
62
142
  // src/main.ts
63
- import './assets/main.css'
143
+ import './assets/css/main.css'
64
144
  import { createApp } from 'vue'
65
145
  import { createRouter, createWebHistory } from 'vue-router'
66
146
  import ui from '@nuxt/ui/vue-plugin'
67
147
  import App from './App.vue'
68
148
 
69
149
  const app = createApp(App)
70
-
71
150
  const router = createRouter({
72
151
  routes: [],
73
152
  history: createWebHistory()
@@ -79,7 +158,7 @@ app.mount('#app')
79
158
  ```
80
159
 
81
160
  ```css
82
- /* assets/main.css */
161
+ /* src/assets/css/main.css */
83
162
  @import "tailwindcss";
84
163
  @import "@nuxt/ui";
85
164
  ```
@@ -93,242 +172,5 @@ app.mount('#app')
93
172
  </template>
94
173
  ```
95
174
 
96
- > **Vue**: Add `class="isolate"` to your root `<div id="app">` in `index.html`.
97
-
98
- > **Vue + Inertia**: Use `ui({ router: 'inertia' })` in `vite.config.ts`.
99
-
100
- ### UApp
101
-
102
- Wrapping your app in `UApp` is **required** — it provides global config for toasts, tooltips, and programmatic overlays. It also accepts a `locale` prop for i18n (see [composables reference](references/composables.md)).
103
-
104
- ## Icons
105
-
106
- Nuxt UI uses [Iconify](https://iconify.design/) for 200,000+ icons. In Nuxt, `@nuxt/icon` is auto-registered. In Vue, icons work out of the box via the Vite plugin.
107
-
108
- ### Naming convention
109
-
110
- Icons use the format `i-{collection}-{name}`:
111
-
112
- ```vue
113
- <UIcon name="i-lucide-sun" class="size-5" />
114
- <UButton icon="i-lucide-plus" label="Add" />
115
- <UAlert icon="i-lucide-info" title="Heads up" />
116
- ```
117
-
118
- > Browse all icons at [icones.js.org](https://icones.js.org). The `lucide` collection is used throughout Nuxt UI defaults.
119
-
120
- ### Install icon collections locally
121
-
122
- ```bash
123
- pnpm i @iconify-json/lucide
124
- pnpm i @iconify-json/simple-icons
125
- ```
126
-
127
- ### Custom local collections (Nuxt)
128
-
129
- ```ts
130
- // nuxt.config.ts
131
- export default defineNuxtConfig({
132
- icon: {
133
- customCollections: [{
134
- prefix: 'custom',
135
- dir: './app/assets/icons'
136
- }]
137
- }
138
- })
139
- ```
140
-
141
- ```vue
142
- <UIcon name="i-custom-my-icon" />
143
- ```
144
-
145
- ## Theming & Branding
146
-
147
- Nuxt UI ships with a default look. The goal is to adapt it to your brand so every app looks unique.
148
-
149
- **Always use semantic utilities** (`text-default`, `bg-elevated`, `border-muted`), never raw Tailwind palette colors. See [references/theming.md](references/theming.md) for the full list.
150
-
151
- ### Colors
152
-
153
- 7 semantic colors (`primary`, `secondary`, `success`, `info`, `warning`, `error`, `neutral`) configurable at runtime:
154
-
155
- ```ts
156
- // Nuxt — app.config.ts
157
- export default defineAppConfig({
158
- ui: { colors: { primary: 'indigo', neutral: 'zinc' } }
159
- })
160
- ```
161
-
162
- ```ts
163
- // Vue — vite.config.ts
164
- import { defineConfig } from 'vite'
165
- import vue from '@vitejs/plugin-vue'
166
- import ui from '@nuxt/ui/vite'
167
-
168
- export default defineConfig({
169
- plugins: [
170
- vue(),
171
- ui({
172
- ui: { colors: { primary: 'indigo', neutral: 'zinc' } }
173
- })
174
- ]
175
- })
176
- ```
177
-
178
- ### Customizing components
179
-
180
- **Override priority** (highest wins): `ui` prop / `class` prop > global config > theme defaults.
181
-
182
- The `ui` prop overrides a component's **slots** after variants are computed — it wins over everything:
183
-
184
- ```vue
185
- <UButton :ui="{ base: 'rounded-none', trailingIcon: 'size-3 rotate-90' }" />
186
- <UCard :ui="{ header: 'bg-muted', body: 'p-8' }" />
187
- ```
188
-
189
- **Read the generated theme file** to find slot names for any component:
190
-
191
- - **Nuxt**: `.nuxt/ui/<component>.ts`
192
- - **Vue**: `node_modules/.nuxt-ui/ui/<component>.ts`
193
-
194
- > For CSS variables, custom colors, global config, compound variants, and a **full brand customization playbook**, see [references/theming.md](references/theming.md)
195
-
196
- ## Composables
197
-
198
- ```ts
199
- // Notifications
200
- const toast = useToast()
201
- toast.add({ title: 'Saved', color: 'success', icon: 'i-lucide-check' })
202
-
203
- // Programmatic overlays
204
- const overlay = useOverlay()
205
- const modal = overlay.create(MyModal)
206
- const { result } = modal.open({ title: 'Confirm' })
207
- await result
208
-
209
- // Keyboard shortcuts
210
- defineShortcuts({
211
- meta_k: () => openSearch(),
212
- escape: () => close()
213
- })
214
- ```
215
-
216
- > For full composable reference, see [references/composables.md](references/composables.md)
217
-
218
- ## Form validation
219
-
220
- Uses Standard Schema — works with Zod, Valibot, Yup, or Joi.
221
-
222
- ```vue
223
- <script setup lang="ts">
224
- import { z } from 'zod'
225
-
226
- const schema = z.object({
227
- email: z.string().email('Invalid email'),
228
- password: z.string().min(8, 'Min 8 characters')
229
- })
230
-
231
- type Schema = z.output<typeof schema>
232
- const state = reactive<Partial<Schema>>({ email: '', password: '' })
233
-
234
- function onSubmit() {
235
- // UForm validates before emitting @submit — state is valid here
236
- }
237
- </script>
238
-
239
- <template>
240
- <UForm :schema="schema" :state="state" @submit="onSubmit">
241
- <UFormField name="email" label="Email" required>
242
- <UInput v-model="state.email" type="email" />
243
- </UFormField>
244
-
245
- <UFormField name="password" label="Password" required>
246
- <UInput v-model="state.password" type="password" />
247
- </UFormField>
248
-
249
- <UButton type="submit">Sign in</UButton>
250
- </UForm>
251
- </template>
252
- ```
253
-
254
- > For all form components and validation patterns, see [references/components.md](references/components.md#form)
255
-
256
- ## Overlays
257
-
258
- ```vue
259
- <!-- Modal -->
260
- <UModal v-model:open="isOpen" title="Edit" description="Edit your profile">
261
- <template #body>Content</template>
262
- <template #footer>
263
- <UButton variant="ghost" @click="isOpen = false">Cancel</UButton>
264
- <UButton @click="save">Save</UButton>
265
- </template>
266
- </UModal>
267
-
268
- <!-- Slideover (side panel) -->
269
- <USlideover v-model:open="isOpen" title="Settings" side="right">
270
- <template #body>Content</template>
271
- </USlideover>
272
-
273
- <!-- Dropdown menu (flat array) -->
274
- <UDropdownMenu :items="[
275
- { label: 'Edit', icon: 'i-lucide-pencil' },
276
- { type: 'separator' },
277
- { label: 'Delete', icon: 'i-lucide-trash', color: 'error' }
278
- ]">
279
- <UButton icon="i-lucide-ellipsis-vertical" variant="ghost" />
280
- </UDropdownMenu>
281
-
282
- <!-- Dropdown menu (nested array — groups with automatic separators) -->
283
- <UDropdownMenu :items="[
284
- [{ label: 'Edit', icon: 'i-lucide-pencil' }, { label: 'Duplicate', icon: 'i-lucide-copy' }],
285
- [{ label: 'Delete', icon: 'i-lucide-trash', color: 'error' }]
286
- ]">
287
- <UButton icon="i-lucide-ellipsis-vertical" variant="ghost" />
288
- </UDropdownMenu>
289
- ```
290
-
291
- > For all overlay components, see [references/components.md](references/components.md#overlay)
292
-
293
- ## Layouts
294
-
295
- Nuxt UI provides components to compose full page layouts. Load the reference matching your use case:
296
-
297
- | Layout | Description | Reference |
298
- |---|---|---|
299
- | Page | Landing, blog, changelog, pricing — public-facing pages | [layouts/page.md](references/layouts/page.md) |
300
- | Dashboard | Admin UI with resizable sidebar and panels | [layouts/dashboard.md](references/layouts/dashboard.md) |
301
- | Docs | Documentation with sidebar nav and TOC | [layouts/docs.md](references/layouts/docs.md) |
302
- | Chat | AI chat with messages and prompt | [layouts/chat.md](references/layouts/chat.md) |
303
- | Editor | Rich text editor with toolbars | [layouts/editor.md](references/layouts/editor.md) |
304
-
305
- ## Templates
306
-
307
- Official starter templates at [github.com/nuxt-ui-templates](https://github.com/nuxt-ui-templates):
308
-
309
- | Template | Framework | GitHub |
310
- |---|---|---|
311
- | Starter | Nuxt | [nuxt-ui-templates/starter](https://github.com/nuxt-ui-templates/starter) |
312
- | Starter | Vue | [nuxt-ui-templates/starter-vue](https://github.com/nuxt-ui-templates/starter-vue) |
313
- | Dashboard | Nuxt | [nuxt-ui-templates/dashboard](https://github.com/nuxt-ui-templates/dashboard) |
314
- | Dashboard | Vue | [nuxt-ui-templates/dashboard-vue](https://github.com/nuxt-ui-templates/dashboard-vue) |
315
- | SaaS | Nuxt | [nuxt-ui-templates/saas](https://github.com/nuxt-ui-templates/saas) |
316
- | Landing | Nuxt | [nuxt-ui-templates/landing](https://github.com/nuxt-ui-templates/landing) |
317
- | Docs | Nuxt | [nuxt-ui-templates/docs](https://github.com/nuxt-ui-templates/docs) |
318
- | Portfolio | Nuxt | [nuxt-ui-templates/portfolio](https://github.com/nuxt-ui-templates/portfolio) |
319
- | Chat | Nuxt | [nuxt-ui-templates/chat](https://github.com/nuxt-ui-templates/chat) |
320
- | Editor | Nuxt | [nuxt-ui-templates/editor](https://github.com/nuxt-ui-templates/editor) |
321
- | Changelog | Nuxt | [nuxt-ui-templates/changelog](https://github.com/nuxt-ui-templates/changelog) |
322
- | Starter | Laravel | [nuxt-ui-templates/starter-laravel](https://github.com/nuxt-ui-templates/starter-laravel) |
323
- | Starter | AdonisJS | [nuxt-ui-templates/starter-adonis](https://github.com/nuxt-ui-templates/starter-adonis) |
324
-
325
- > When starting a new project, clone the matching template instead of setting up from scratch.
326
-
327
- ## Additional references
328
-
329
- Load based on your task — **do not load all at once**:
330
-
331
- - [references/theming.md](references/theming.md) — CSS variables, custom colors, component theme overrides
332
- - [references/components.md](references/components.md) — all 125+ components by category with props and usage
333
- - [references/composables.md](references/composables.md) — useToast, useOverlay, defineShortcuts
334
- - Generated theme files — all slots, variants, and default classes for any component (Nuxt: `.nuxt/ui/<component>.ts`, Vue: `node_modules/.nuxt-ui/ui/<component>.ts`)
175
+ > Add `class="isolate"` to your root `<div id="app">` in `index.html`.
176
+ > For Inertia: use `ui({ router: 'inertia' })` in `vite.config.ts`.