create-velox-app 0.6.64 → 0.6.65

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # create-velox-app
 
+## 0.6.65
+
+### Patch Changes
+
+- improve ai integration and simplify api router definition
+
 ## 0.6.64
 
 ### Patch Changes

package/dist/templates/auth.js

@@ -50,9 +50,6 @@ function generateIndexTs() {
 function generateRouterTs() {
     return compileTemplate('api/router.auth.ts', AUTH_CONFIG);
 }
-function generateRouterTypesTs() {
-    return compileTemplate('api/router.types.auth.ts', AUTH_CONFIG);
-}
 function generateConfigDatabase(config) {
     return compileTemplate('api/config/database.ts', config);
 }
@@ -68,9 +65,6 @@ function generateAuthSchema() {
 function generateHealthSchema() {
     return compileTemplate('api/schemas/health.ts', AUTH_CONFIG);
 }
-function generateRoutes() {
-    return compileTemplate('api/routes.auth.ts', AUTH_CONFIG);
-}
 function generateApiTypesDts() {
     return compileTemplate('api/types.d.ts', AUTH_CONFIG);
 }
@@ -96,7 +90,6 @@ export function generateAuthTemplate(config) {
         { path: 'apps/api/prisma/schema.prisma', content: generatePrismaSchema(config) },
         // API Source files
         { path: 'apps/api/src/router.ts', content: generateRouterTs() },
-        { path: 'apps/api/src/router.types.ts', content: generateRouterTypesTs() },
         { path: 'apps/api/src/index.ts', content: generateIndexTs() },
         { path: 'apps/api/src/config/app.ts', content: generateConfigApp(config) },
         { path: 'apps/api/src/config/auth.ts', content: generateAuthConfig() },
@@ -107,7 +100,6 @@ export function generateAuthTemplate(config) {
         { path: 'apps/api/src/schemas/user.ts', content: generateUserSchema() },
         { path: 'apps/api/src/schemas/auth.ts', content: generateAuthSchema() },
         { path: 'apps/api/src/schemas/health.ts', content: generateHealthSchema() },
-        { path: 'apps/api/src/routes.ts', content: generateRoutes() },
         { path: 'apps/api/src/types.d.ts', content: generateApiTypesDts() },
         { path: 'apps/api/src/utils/auth.ts', content: generateAuthUtils() },
     ];

package/dist/templates/shared/root.d.ts

@@ -12,4 +12,11 @@ export declare function generateRootReadme(config: TemplateConfig): string;
 export type TemplateVariant = 'default' | 'auth' | 'trpc';
 export declare function generateRootClaudeMd(config: TemplateConfig, variant: TemplateVariant | boolean): string;
 export declare function generateRootCursorrules(config: TemplateConfig): string;
+/**
+ * Generate VeloxTS skill files for Claude Code
+ *
+ * These skills provide project-aware guidance to Claude when working on
+ * VeloxTS projects. Skills are Markdown files with YAML frontmatter.
+ */
+export declare function generateClaudeSkillFiles(config: TemplateConfig): TemplateFile[];
 export declare function generateRootFiles(config: TemplateConfig, variant?: TemplateVariant | boolean): TemplateFile[];

package/dist/templates/shared/root.js

@@ -57,6 +57,36 @@ export function generateRootCursorrules(config) {
     return compileTemplate('root/.cursorrules', config);
 }
 // ============================================================================
+// Claude Code Skills
+// ============================================================================
+/**
+ * Generate VeloxTS skill files for Claude Code
+ *
+ * These skills provide project-aware guidance to Claude when working on
+ * VeloxTS projects. Skills are Markdown files with YAML frontmatter.
+ */
+export function generateClaudeSkillFiles(config) {
+    const skillPath = '.claude/skills/veloxts';
+    return [
+        {
+            path: `${skillPath}/SKILL.md`,
+            content: compileTemplate('root/.claude/skills/veloxts/SKILL.md', config),
+        },
+        {
+            path: `${skillPath}/GENERATORS.md`,
+            content: compileTemplate('root/.claude/skills/veloxts/GENERATORS.md', config),
+        },
+        {
+            path: `${skillPath}/PROCEDURES.md`,
+            content: compileTemplate('root/.claude/skills/veloxts/PROCEDURES.md', config),
+        },
+        {
+            path: `${skillPath}/TROUBLESHOOTING.md`,
+            content: compileTemplate('root/.claude/skills/veloxts/TROUBLESHOOTING.md', config),
+        },
+    ];
+}
+// ============================================================================
 // Generate All Root Files
 // ============================================================================
 export function generateRootFiles(config, variant = 'default') {
@@ -68,5 +98,7 @@ export function generateRootFiles(config, variant = 'default') {
         { path: 'README.md', content: generateRootReadme(config) },
         { path: 'CLAUDE.md', content: generateRootClaudeMd(config, variant) },
         { path: '.cursorrules', content: generateRootCursorrules(config) },
+        // Claude Code skills for project-specific guidance
+        ...generateClaudeSkillFiles(config),
     ];
 }

package/dist/templates/spa.js

@@ -35,9 +35,6 @@ function generatePrismaConfig() {
 function generateRouterTs() {
     return compileTemplate('api/router.default.ts', DEFAULT_CONFIG);
 }
-function generateRouterTypesTs() {
-    return compileTemplate('api/router.types.default.ts', DEFAULT_CONFIG);
-}
 function generateIndexTs() {
     return compileTemplate('api/index.default.ts', DEFAULT_CONFIG);
 }
@@ -59,9 +56,6 @@ function generateUserSchema() {
 function generateHealthSchema() {
     return compileTemplate('api/schemas/health.ts', DEFAULT_CONFIG);
 }
-function generateRoutes() {
-    return compileTemplate('api/routes.default.ts', DEFAULT_CONFIG);
-}
 function generateApiTypesDts() {
     return compileTemplate('api/types.d.ts', DEFAULT_CONFIG);
 }
@@ -84,7 +78,6 @@ export function generateSpaTemplate(config) {
         { path: 'apps/api/prisma/schema.prisma', content: generatePrismaSchema(config) },
         // API Source files
         { path: 'apps/api/src/router.ts', content: generateRouterTs() },
-        { path: 'apps/api/src/router.types.ts', content: generateRouterTypesTs() },
         { path: 'apps/api/src/index.ts', content: generateIndexTs() },
         { path: 'apps/api/src/config/app.ts', content: generateConfigApp(config) },
         { path: 'apps/api/src/config/database.ts', content: generateConfigDatabase(config) },
@@ -92,7 +85,6 @@ export function generateSpaTemplate(config) {
         { path: 'apps/api/src/procedures/users.ts', content: generateUserProcedures() },
         { path: 'apps/api/src/schemas/user.ts', content: generateUserSchema() },
         { path: 'apps/api/src/schemas/health.ts', content: generateHealthSchema() },
-        { path: 'apps/api/src/routes.ts', content: generateRoutes() },
         { path: 'apps/api/src/types.d.ts', content: generateApiTypesDts() },
     ];
     // Add docker-compose for PostgreSQL

package/dist/templates/trpc.js

@@ -41,9 +41,6 @@ function generatePrismaConfig() {
 function generateRouterTs() {
     return compileTemplate('api/router.trpc.ts', TRPC_CONFIG);
 }
-function generateRouterTypesTs() {
-    return compileTemplate('api/router.types.trpc.ts', TRPC_CONFIG);
-}
 function generateIndexTs() {
     // Use tRPC-specific entry point
     return compileTemplate('api/index.trpc.ts', TRPC_CONFIG);
@@ -67,9 +64,6 @@ function generateUserSchema() {
 function generateHealthSchema() {
     return compileTemplate('api/schemas/health.ts', DEFAULT_CONFIG);
 }
-function generateRoutes() {
-    return compileTemplate('api/routes.default.ts', DEFAULT_CONFIG);
-}
 function generateApiTypesDts() {
     return compileTemplate('api/types.d.ts', DEFAULT_CONFIG);
 }
@@ -92,7 +86,6 @@ export function generateTrpcTemplate(config) {
         { path: 'apps/api/prisma/schema.prisma', content: generatePrismaSchema(config) },
         // API Source files
         { path: 'apps/api/src/router.ts', content: generateRouterTs() },
-        { path: 'apps/api/src/router.types.ts', content: generateRouterTypesTs() },
         { path: 'apps/api/src/index.ts', content: generateIndexTs() },
         { path: 'apps/api/src/config/app.ts', content: generateConfigApp(config) },
         { path: 'apps/api/src/config/database.ts', content: generateConfigDatabase(config) },
@@ -100,7 +93,6 @@ export function generateTrpcTemplate(config) {
         { path: 'apps/api/src/procedures/users.ts', content: generateUserProcedures() },
         { path: 'apps/api/src/schemas/user.ts', content: generateUserSchema() },
         { path: 'apps/api/src/schemas/health.ts', content: generateHealthSchema() },
-        { path: 'apps/api/src/routes.ts', content: generateRoutes() },
         { path: 'apps/api/src/types.d.ts', content: generateApiTypesDts() },
     ];
     // Add docker-compose for PostgreSQL

package/package.json

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

package/src/templates/source/root/.claude/skills/veloxts/GENERATORS.md

@@ -0,0 +1,313 @@
+# VeloxTS Generators Guide
+
+## Decision Tree: Which Generator?
+
+```
+Do you need a new database entity?
+├── YES → Is this a completely new entity?
+│         ├── YES → velox make resource [RECOMMENDED]
+│         │         Creates: Prisma model + Schema + Procedures + Tests
+│         │
+│         └── NO (existing Prisma model) → velox make namespace
+│                   Creates: Schema + Procedures (no Prisma injection)
+│
+└── NO → What do you need?
+         ├── Single API endpoint → velox make procedure
+         ├── Validation schema only → velox make schema
+         ├── Database model only → velox make model
+         ├── Background job → velox make job
+         ├── Email template → velox make mail
+         ├── Auth guard → velox make guard
+         ├── Auth policy → velox make policy
+         ├── Middleware → velox make middleware
+         ├── Service class → velox make service
+         ├── Custom exception → velox make exception
+         └── Scheduled task → velox make task
+```
+
+## Generator Comparison
+
+| Generator | Creates | Use When |
+|-----------|---------|----------|
+| `resource` | Prisma + Schema + Procedures + Tests | **New database entity** (recommended default) |
+| `namespace` | Schema + Procedures | Existing model or external API |
+| `procedure` | Procedures (inline schemas) | Single endpoint, quick prototype |
+| `schema` | Zod schema file | Standalone validation |
+| `model` | Prisma model | Database-only change |
+
+## Resource Generator [RECOMMENDED]
+
+The full-stack generator for new entities. Like Laravel's `make:model -a`.
+
+```bash
+# Basic usage
+velox make resource Post
+
+# Full CRUD with pagination
+velox make resource Post --crud --paginated
+
+# Interactive field definition
+velox make resource Product -i
+
+# With soft delete
+velox make resource Comment --soft-delete
+
+# Auto-run migration
+velox make resource Order --auto-migrate
+
+# Preview without writing
+velox make resource Post --dry-run
+```
+
+### What It Creates
+
+```
+src/
+├── procedures/
+│   ├── posts.ts              # CRUD procedures
+│   └── __tests__/
+│       └── posts.test.ts     # Unit tests
+├── schemas/
+│   └── post.schema.ts        # Zod validation
+└── models/
+    └── post.prisma           # Injected into schema.prisma
+```
+
+### Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--crud` | `-c` | Generate full CRUD operations |
+| `--paginated` | `-P` | Include pagination for list |
+| `--soft-delete` | `-s` | Add soft delete support |
+| `--timestamps` | `-t` | Include timestamps (default: true) |
+| `--with-tests` | `-W` | Generate tests (default: true) |
+| `--interactive` | `-i` | Define fields interactively |
+| `--skip-registration` | | Don't auto-register in router |
+| `--auto-migrate` | | Run migration automatically |
+| `--dry-run` | `-d` | Preview changes only |
+| `--force` | `-f` | Overwrite existing files |
+
+## Namespace Generator
+
+For existing Prisma models or external data sources.
+
+```bash
+# Empty namespace (add procedures manually)
+velox make namespace products
+
+# With example CRUD
+velox make namespace orders --example
+
+# Short form
+velox m ns inventory -e
+```
+
+### What It Creates
+
+```
+src/
+├── procedures/
+│   └── products.ts           # Procedure namespace
+└── schemas/
+    └── product.ts            # Zod schema
+```
+
+### When to Use
+
+- You already have a Prisma model defined
+- You're calling an external API (no database)
+- You want separate schema files (not inline)
+- You don't need Prisma model injection
+
+### Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--example` | `-e` | Include example CRUD procedures |
+| `--skip-registration` | `-S` | Don't auto-register in router |
+
+## Procedure Generator
+
+For single procedures or quick prototypes.
+
+```bash
+# Simple single procedure
+velox make procedure health
+
+# CRUD with inline schemas
+velox make procedure users --crud
+
+# With pagination
+velox make procedure posts --crud --paginated
+```
+
+### What It Creates
+
+```
+src/
+└── procedures/
+    └── users.ts              # Procedures with inline schemas
+```
+
+### When to Use
+
+- Adding a single endpoint (health check, webhook)
+- Quick prototyping
+- Self-contained procedure with inline schemas
+
+### Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--crud` | `-c` | Generate full CRUD operations |
+| `--paginated` | `-P` | Include pagination |
+| `--skip-registration` | `-S` | Don't auto-register |
+
+## Other Generators
+
+### Schema Generator
+
+```bash
+velox make schema User
+velox make schema Post --crud    # With input schemas
+```
+
+### Model Generator
+
+```bash
+velox make model User
+velox make model Post --timestamps
+```
+
+### Job Generator (Background Tasks)
+
+```bash
+velox make job SendWelcomeEmail
+velox make job ProcessOrder --queue
+```
+
+### Mail Generator
+
+```bash
+velox make mail WelcomeEmail
+velox make mail OrderConfirmation --react   # React Email template
+```
+
+### Guard Generator (Authentication)
+
+```bash
+velox make guard admin           # Role-based
+velox make guard verified        # Custom logic
+```
+
+### Policy Generator (Authorization)
+
+```bash
+velox make policy PostPolicy
+velox make policy CommentPolicy --crud
+```
+
+### Middleware Generator
+
+```bash
+velox make middleware logging
+velox make middleware rate-limit
+```
+
+### Service Generator
+
+```bash
+velox make service PaymentService
+velox make service EmailService --injectable
+```
+
+### Exception Generator
+
+```bash
+velox make exception PaymentFailed
+velox make exception ValidationFailed --http
+```
+
+### Task Generator (Scheduled)
+
+```bash
+velox make task CleanupExpiredSessions
+velox make task SendDailyDigest --cron="0 9 * * *"
+```
+
+## Common Workflows
+
+### New Feature: Blog Posts
+
+```bash
+# 1. Generate complete resource
+velox make resource Post --crud --paginated -i
+
+# 2. (Optional) Add related resources
+velox make resource Comment --crud
+velox make resource Tag --crud
+
+# 3. Run migration
+pnpm db:push
+
+# 4. Seed sample data
+velox make seeder PostSeeder
+pnpm velox db seed
+```
+
+### Adding to Existing Model
+
+```bash
+# Model already exists in Prisma
+velox make namespace Order --example
+
+# Or just add schema
+velox make schema Order --crud
+```
+
+### Quick Utility Endpoint
+
+```bash
+# Health check
+velox make procedure health
+
+# Then customize the generated file
+```
+
+### Background Processing
+
+```bash
+# Create job
+velox make job SendWelcomeEmail
+
+# Create mail template
+velox make mail WelcomeEmail --react
+
+# Use in procedure
+createUser: procedure()
+  .input(CreateUserSchema)
+  .mutation(async ({ ctx, input }) => {
+    const user = await ctx.db.user.create({ data: input });
+    await dispatch(SendWelcomeEmail, { userId: user.id });
+    return user;
+  }),
+```
+
+## Generator Aliases
+
+| Full Command | Alias |
+|--------------|-------|
+| `velox make resource` | `velox m r` |
+| `velox make namespace` | `velox m ns` |
+| `velox make procedure` | `velox m p` |
+| `velox make schema` | `velox m s` |
+| `velox make model` | `velox m mod` |
+| `velox make job` | `velox m j` |
+| `velox make mail` | `velox m em` |
+| `velox make guard` | `velox m g` |
+| `velox make policy` | `velox m pol` |
+| `velox make middleware` | `velox m mw` |
+| `velox make service` | `velox m svc` |
+| `velox make exception` | `velox m ex` |
+| `velox make task` | `velox m task` |