create-velox-app 0.6.82 → 0.6.83

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # create-velox-app
 
+## 0.6.83
+
+### Patch Changes
+
+- docs(templates): add /veloxts skill to CLAUDE.md files and links to online documentation
+
 ## 0.6.82
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-velox-app",
-  "version": "0.6.82",
+  "version": "0.6.83",
   "description": "Project scaffolder for VeloxTS framework",
   "type": "module",
   "main": "dist/index.js",

package/src/templates/source/root/CLAUDE.auth.md

@@ -2,6 +2,38 @@
 
 This file provides guidance to Claude Code and other AI assistants.
 
+## Documentation
+
+Full documentation is available at **[veloxts.dev/docs](https://www.veloxts.dev/docs/)**.
+
+## Claude Code Skills
+
+When using Claude Code (CLI), these skills are available:
+
+### `/veloxts` - VeloxTS Development Assistant
+
+```
+/veloxts
+```
+
+VeloxTS-specific help for:
+- Code generation (`velox make resource`, `velox make procedure`)
+- REST route inference from naming conventions
+- Authentication and guards
+- Validation with Zod schemas
+- Troubleshooting common errors
+
+### `/feature-dev` - Guided Feature Development
+
+```
+/feature-dev
+```
+
+General-purpose skill for:
+- Codebase understanding and architecture analysis
+- Step-by-step implementation guidance
+- Best practices for VeloxTS patterns
+
 ## Project Overview
 
 **__PROJECT_NAME__** is a VeloxTS full-stack application with:
@@ -54,7 +86,7 @@ export const postProcedures = procedures('posts', {
     .input(z.object({ id: z.string().uuid() }))
     .output(PostSchema)
     .query(async ({ input, ctx }) => {
-      return ctx.db.post.findUnique({ where: { id: input.id } });
+      return ctx.db.post.findUniqueOrThrow({ where: { id: input.id } });
     }),
 
   // POST /api/posts
@@ -403,7 +435,7 @@ registerPolicy('Post', PostPolicy);
 const deletePost = procedure()
   .guard(authenticated)
   .mutation(async ({ ctx, input }) => {
-    const post = await ctx.db.post.findUnique({ where: { id: input.id } });
+    const post = await ctx.db.post.findUniqueOrThrow({ where: { id: input.id } });
 
     // Throws 403 if unauthorized
     await authorize(ctx.user, 'delete', 'Post', post);
@@ -564,13 +596,7 @@ import { VeloxError } from '@veloxts/core';
 const getUser = procedure()
   .input(z.object({ id: z.string().uuid() }))
   .query(async ({ ctx, input }) => {
-    const user = await ctx.db.user.findUnique({ where: { id: input.id } });
-
-    if (!user) {
-      throw VeloxError.notFound('User', input.id);
-    }
-
-    return user;
+    return ctx.db.user.findUniqueOrThrow({ where: { id: input.id } });
   });
 ```
 

package/src/templates/source/root/CLAUDE.default.md

@@ -2,6 +2,38 @@
 
 This file provides guidance to Claude Code and other AI assistants.
 
+## Documentation
+
+Full documentation is available at **[veloxts.dev/docs](https://www.veloxts.dev/docs/)**.
+
+## Claude Code Skills
+
+When using Claude Code (CLI), these skills are available:
+
+### `/veloxts` - VeloxTS Development Assistant
+
+```
+/veloxts
+```
+
+VeloxTS-specific help for:
+- Code generation (`velox make resource`, `velox make procedure`)
+- REST route inference from naming conventions
+- Authentication and guards
+- Validation with Zod schemas
+- Troubleshooting common errors
+
+### `/feature-dev` - Guided Feature Development
+
+```
+/feature-dev
+```
+
+General-purpose skill for:
+- Codebase understanding and architecture analysis
+- Step-by-step implementation guidance
+- Best practices for VeloxTS patterns
+
 ## Project Overview
 
 **__PROJECT_NAME__** is a VeloxTS full-stack application with:
@@ -53,7 +85,7 @@ export const postProcedures = procedures('posts', {
     .input(z.object({ id: z.string().uuid() }))
     .output(PostSchema)
     .query(async ({ input, ctx }) => {
-      return ctx.db.post.findUnique({ where: { id: input.id } });
+      return ctx.db.post.findUniqueOrThrow({ where: { id: input.id } });
     }),
 
   // POST /api/posts
@@ -388,13 +420,7 @@ import { VeloxError } from '@veloxts/core';
 const getUser = procedure()
   .input(z.object({ id: z.string().uuid() }))
   .query(async ({ ctx, input }) => {
-    const user = await ctx.db.user.findUnique({ where: { id: input.id } });
-
-    if (!user) {
-      throw VeloxError.notFound('User', input.id);
-    }
-
-    return user;
+    return ctx.db.user.findUniqueOrThrow({ where: { id: input.id } });
   });
 ```
 

package/src/templates/source/root/CLAUDE.trpc.md

@@ -2,6 +2,37 @@
 
 This file provides guidance to Claude Code and other AI assistants.
 
+## Documentation
+
+Full documentation is available at **[veloxts.dev/docs](https://www.veloxts.dev/docs/)**.
+
+## Claude Code Skills
+
+When using Claude Code (CLI), these skills are available:
+
+### `/veloxts` - VeloxTS Development Assistant
+
+```
+/veloxts
+```
+
+VeloxTS-specific help for:
+- Code generation (`velox make resource`, `velox make procedure`)
+- tRPC procedure patterns
+- Validation with Zod schemas
+- Troubleshooting common errors
+
+### `/feature-dev` - Guided Feature Development
+
+```
+/feature-dev
+```
+
+General-purpose skill for:
+- Codebase understanding and architecture analysis
+- Step-by-step implementation guidance
+- Best practices for VeloxTS patterns
+
 ## Project Overview
 
 **__PROJECT_NAME__** is a VeloxTS full-stack application using **tRPC-only** architecture:
@@ -77,7 +108,7 @@ export const postProcedures = procedures('posts', {
     .input(z.object({ id: z.string().uuid() }))
     .output(PostSchema)
     .query(async ({ input, ctx }) => {
-      return ctx.db.post.findUnique({ where: { id: input.id } });
+      return ctx.db.post.findUniqueOrThrow({ where: { id: input.id } });
     }),
 
   // tRPC mutation
@@ -307,13 +338,7 @@ import { VeloxError } from '@veloxts/core';
 const getPost = procedure()
   .input(z.object({ id: z.string().uuid() }))
   .query(async ({ ctx, input }) => {
-    const post = await ctx.db.post.findUnique({ where: { id: input.id } });
-
-    if (!post) {
-      throw VeloxError.notFound('Post', input.id);
-    }
-
-    return post;
+    return ctx.db.post.findUniqueOrThrow({ where: { id: input.id } });
   });
 ```
 

package/src/templates/source/rsc/CLAUDE.md

@@ -2,6 +2,38 @@
 
 This is a VeloxTS full-stack application using React Server Components.
 
+## Documentation
+
+Full documentation is available at **[veloxts.dev/docs](https://www.veloxts.dev/docs/)**.
+
+## Claude Code Skills
+
+When using Claude Code (CLI), these skills are available:
+
+### `/veloxts` - VeloxTS Development Assistant
+
+```
+/veloxts
+```
+
+VeloxTS-specific help for:
+- Code generation (`velox make resource`, `velox make procedure`)
+- REST route inference from naming conventions
+- Server actions with `validated()`
+- Validation with Zod schemas
+- Troubleshooting common errors
+
+### `/feature-dev` - Guided Feature Development
+
+```
+/feature-dev
+```
+
+General-purpose skill for:
+- Codebase understanding and architecture analysis
+- Step-by-step implementation guidance
+- Best practices for VeloxTS patterns
+
 ## Project Structure
 
 ```

package/src/templates/source/rsc-auth/CLAUDE.md

@@ -2,6 +2,38 @@
 
 This is a VeloxTS full-stack application using React Server Components with JWT Authentication.
 
+## Documentation
+
+Full documentation is available at **[veloxts.dev/docs](https://www.veloxts.dev/docs/)**.
+
+## Claude Code Skills
+
+When using Claude Code (CLI), these skills are available:
+
+### `/veloxts` - VeloxTS Development Assistant
+
+```
+/veloxts
+```
+
+VeloxTS-specific help for:
+- Code generation (`velox make resource`, `velox make procedure`)
+- REST route inference from naming conventions
+- Authentication and guards
+- Server actions with `validated()`
+- Troubleshooting common errors
+
+### `/feature-dev` - Guided Feature Development
+
+```
+/feature-dev
+```
+
+General-purpose skill for:
+- Codebase understanding and architecture analysis
+- Step-by-step implementation guidance
+- Best practices for VeloxTS patterns
+
 ## Project Structure
 
 ```