create-wervt 0.2.5 → 0.2.6

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/package.json +1 -1
  2. package/template/.claude/skills/nuxt-ui/SKILL.md +334 -0
  3. package/template/.claude/skills/nuxt-ui/references/components.md +377 -0
  4. package/template/.claude/skills/nuxt-ui/references/composables.md +127 -0
  5. package/template/.claude/skills/nuxt-ui/references/layouts/chat.md +195 -0
  6. package/template/.claude/skills/nuxt-ui/references/layouts/dashboard.md +220 -0
  7. package/template/.claude/skills/nuxt-ui/references/layouts/docs.md +141 -0
  8. package/template/.claude/skills/nuxt-ui/references/layouts/editor.md +167 -0
  9. package/template/.claude/skills/nuxt-ui/references/layouts/page.md +260 -0
  10. package/template/.claude/skills/nuxt-ui/references/theming.md +427 -0
  11. package/template/.claude/skills/nuxt-ui-mobile/SKILL.md +92 -0
  12. package/template/.claude/skills/nuxt-ui-mobile/examples/app/composables/useDemoItems.ts +18 -0
  13. package/template/.claude/skills/nuxt-ui-mobile/examples/app/pages/index.vue +121 -0
  14. package/template/.claude/skills/nuxt-ui-mobile/examples/app/pages/items/[id].vue +77 -0
  15. package/template/.claude/skills/nuxt-ui-mobile/examples/app/pages/settings/index.vue +71 -0
  16. package/template/.claude/skills/nuxt-ui-mobile/examples/app/pages/settings/sort.vue +23 -0
  17. package/template/.claude/skills/nuxt-ui-mobile/references/patterns.md +212 -0
  18. package/template/.claude/skills/nuxt-ui-mobile/references/review-checklist.md +49 -0
  19. package/template/.claude/skills/nuxt-ui-mobile/references/tokens.md +86 -0
  20. package/template/.claude/skills/nuxt-ui-mobile/scripts/gen-palette.mjs +58 -0
  21. package/template/.claude/skills/nuxt-ui-mobile/template/app/app.config.ts +298 -0
  22. package/template/.claude/skills/nuxt-ui-mobile/template/app/app.vue +8 -0
  23. package/template/.claude/skills/nuxt-ui-mobile/template/app/assets/css/main.css +331 -0
  24. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/ActionSheet.vue +47 -0
  25. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/ListRow.vue +73 -0
  26. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/ListSection.vue +26 -0
  27. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/NavBar.vue +88 -0
  28. package/template/.claude/skills/nuxt-ui-mobile/template/app/components/mobile/TabBar.vue +45 -0
  29. package/template/.claude/skills/nuxt-ui-mobile/template/app/layouts/default.vue +16 -0
  30. package/template/.claude/skills/nuxt-ui-mobile/template/app/layouts/plain.vue +6 -0
  31. package/template/.claude/skills/nuxt-ui-mobile/template/nuxt.config.ts +27 -0
  32. package/template/AGENTS.md +23 -2
  33. package/template/package.json +2 -2
@@ -10,6 +10,24 @@ Supabase Edge Runtime) with its own Postgres schema and live data through Electr
10
10
  - `server/api/`: API routes. `server/api/shapes/`: live data routes.
11
11
  - `server/db/schema.ts`: the Drizzle schema. `drizzle/`: generated migrations. Commit both.
12
12
 
13
+ ## UI
14
+
15
+ Pick the UI stack by the kind of app:
16
+
17
+ - **Clean web apps and sites** (tools, dashboards, forms, content pages): Nuxt UI v4
18
+ (`pnpm add @nuxt/ui`, add `'@nuxt/ui'` to `modules`). Use its components and theme them in
19
+ `app.config.ts` instead of rebuilding them. Skill: `nuxt-ui`.
20
+ - **Playful or individual designs** that don't fit Nuxt UI's look (games, toys, landing pages with
21
+ their own identity): Reka UI (`reka-ui`) for accessible behavior (dialogs, menus, popovers,
22
+ sliders, …) and Tailwind CSS with your own styles on top. Don't bend Nuxt UI's theme into a
23
+ different design.
24
+ - **Pure mobile apps** (used mainly on phones, should feel like a native iOS app): Nuxt UI with the
25
+ `nuxt-ui-mobile` skill. Read its `SKILL.md` before writing UI and follow its rules. Its
26
+ `template/app/*` files go to the project root here: this app keeps `app.vue`, `pages/` and
27
+ `components/` at the root, not in `app/`.
28
+
29
+ Reka UI primitives are fine inside a Nuxt UI app for a one-off component Nuxt UI doesn't have.
30
+
13
31
  ## Server routes
14
32
 
15
33
  Use `defineEventHandler` and friends from `nuxt/server` (never `h3` or `nitro/h3`), and validate
@@ -106,8 +124,11 @@ own bucket and `@wervt/nuxt` connects it; don't configure a provider or S3 crede
106
124
 
107
125
  - `readUploadedFile(event, { types, maxSize })`, `useFileStorage().put/get/list/remove` and
108
126
  `sendStoredFile(event, ref)` (route files without a method suffix) from `#imports`.
109
- - Keep files to a few tens of MB: they pass through the isolate (150 MB memory). No tus uploads
110
- and no `transform` / sharp: they need a disk and native modules.
127
+ - Files through a route stay under a few tens of MB: they pass through the isolate (150 MB
128
+ memory). Larger files (video): `useFileStorage().createUpload/completeUpload/abortUpload` in
129
+ three routes plus `useDirectUpload()` on the page, so browsers upload straight to the bucket;
130
+ serve them with `signedUrl(file)`, a presigned link to the bucket.
131
+ - No tus uploads and no `transform` / sharp: they need a disk and native modules.
111
132
  - Check access in the route before serving a file.
112
133
 
113
134
  ## Tasks (cron)
@@ -9,13 +9,13 @@
9
9
  "postinstall": "nuxt prepare"
10
10
  },
11
11
  "dependencies": {
12
- "@wervt/nuxt": "^0.2.3",
12
+ "@wervt/nuxt": "^0.2.7",
13
13
  "drizzle-orm": "1.0.0-rc.4",
14
14
  "nuxt": "npm:nuxt-nightly@5x",
15
15
  "valibot": "^1.5.0"
16
16
  },
17
17
  "devDependencies": {
18
- "@wervt/cli": "^0.2.5",
18
+ "@wervt/cli": "^0.2.6",
19
19
  "drizzle-kit": "1.0.0-rc.4",
20
20
  "vite-plus": "^1.0.0"
21
21
  }