create-tigra 1.0.0 → 1.0.2

package/bin/create-tigra.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { Command } from 'commander';
 import prompts from 'prompts';
@@ -80,7 +80,6 @@ const filesToProcess = [
     'CLAUDE.md',
     // Server files
     'server/package.json',
-    'server/.env',
     'server/.env.example',
     'server/docker-compose.yml',
     'server/README.md',
@@ -100,6 +99,11 @@ const excludePatterns = [
     'coverage',
     'build-errors.txt',
     '.env.local',
+    '.env',
+    '*.tsbuildinfo',
+    'tsconfig.build.tsbuildinfo',
+    '.DS_Store',
+    'Thumbs.db',
 ];
 
 // ==============================================
@@ -278,7 +282,7 @@ program
             console.log();
             console.log(chalk.gray('  URLs after starting:'));
             console.log(chalk.gray('    API Server:  http://localhost:3000'));
-            console.log(chalk.gray('    API Docs:    http://localhost:3000/docs'));
+            console.log(chalk.gray('    Health Check: http://localhost:3000/health'));
             console.log(chalk.gray('    phpMyAdmin:  http://localhost:8080 (root / password)'));
             console.log(chalk.gray('    Redis UI:    http://localhost:8081'));
             console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-tigra",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "description": "Create a production-ready Fastify + TypeScript + Prisma API server",
   "keywords": [

package/template/server/.env.example

@@ -1,148 +1,69 @@
-# ==============================================
-# SERVER CONFIGURATION
-# ==============================================
-
-# Environment: development | production | test
-NODE_ENV=development
-
-# Server port
-PORT=3000
-
-# API base path (e.g., /api/v1)
-API_PREFIX=/api/v1
-
-# Logging level: trace | debug | info | warn | error | fatal
-LOG_LEVEL=info
-
-# ==============================================
-# DATABASE CONFIGURATION (MySQL)
-# ==============================================
-
-# MySQL connection string format:
-# mysql://USER:PASSWORD@HOST:PORT/DATABASE
-# For local development with Docker:
-DATABASE_URL="mysql://root:{{DATABASE_PASSWORD}}@localhost:3306/{{DATABASE_NAME}}"
-
-# For production (example):
-# DATABASE_URL="mysql://user:secure_password@db.example.com:3306/{{DATABASE_NAME}}_production?connection_limit=10&pool_timeout=20"
-
-# ==============================================
-# REDIS CONFIGURATION
-# ==============================================
-
-# Redis host
-REDIS_HOST=localhost
-
-# Redis port
-REDIS_PORT=6379
-
-# Redis password (leave empty for local development)
-REDIS_PASSWORD=
-
-# Redis database number (0-15)
-REDIS_DB=0
-
-# ==============================================
-# JWT AUTHENTICATION
-# ==============================================
-
-# JWT secret key - CHANGE THIS IN PRODUCTION!
-# Generate with: openssl rand -base64 32
-JWT_SECRET=123412341234123412341234123412341234123412341234123412341234
-
-# Access token expiration (e.g., 15m, 1h, 7d)
-JWT_ACCESS_EXPIRATION=15m
-
-# Refresh token expiration (e.g., 7d, 30d, 90d)
-JWT_REFRESH_EXPIRATION=7d
-
-# JWT issuer (optional)
-JWT_ISSUER={{PROJECT_NAME}}
-
-# ==============================================
-# CORS CONFIGURATION
-# ==============================================
-
-# Allowed origins (comma-separated)
-# For development:
-CORS_ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000
-
-# For production:
-# CORS_ALLOWED_ORIGINS=https://yourdomain.com,https://www.yourdomain.com
-
-
-# ==============================================
-# FILE UPLOAD CONFIGURATION
-# ==============================================
-
-# Maximum file size in bytes (10MB default)
-MAX_FILE_SIZE=10485760
-
-# Allowed file types (comma-separated)
-ALLOWED_FILE_TYPES=image/jpeg,image/png,image/webp,application/pdf
-
-# Upload directory
-UPLOAD_DIR=./uploads
-
-# ==============================================
-# RATE LIMITING
-# ==============================================
-
-# Global rate limit (requests per time window)
-RATE_LIMIT_MAX=100
-
-# Time window in milliseconds (15 minutes = 900000)
-RATE_LIMIT_WINDOW=900000
-
-# ==============================================
-# MONITORING & ERROR TRACKING
-# ==============================================
-
-# ==============================================
-# API DOCUMENTATION (Swagger)
-# ==============================================
-
-# Enable Swagger UI (true/false)
-# Set to false in production for security
-SWAGGER_ENABLED=true
-
-# Swagger route prefix
-SWAGGER_ROUTE=/docs
-
-# ==============================================
-# EXTERNAL SERVICES (Optional)
-# ==============================================
-
-# AWS S3 (for file storage)
-# AWS_ACCESS_KEY_ID=
-# AWS_SECRET_ACCESS_KEY=
-# AWS_REGION=us-east-1
-# AWS_S3_BUCKET=
-
-# Stripe (for payments)
-# STRIPE_SECRET_KEY=
-# STRIPE_WEBHOOK_SECRET=
-
-
-
-# ==============================================
-# DEVELOPMENT TOOLS
-# ==============================================
-
-# Enable query logging in development
-PRISMA_QUERY_LOG=false
-
-# Enable slow query warnings (milliseconds)
-SLOW_QUERY_THRESHOLD=1000
-
-# ==============================================
-# ADMIN SEED (Initial Setup)
-# ==============================================
-
-# Admin user email for database seeding
-# Change this before running npm run prisma:seed
-ADMIN_EMAIL=admin@{{PROJECT_NAME}}.dev
-
-# Admin user password for database seeding
-# CHANGE THIS IMMEDIATELY AFTER FIRST LOGIN!
-ADMIN_PASSWORD=ChangeThisPassword123!
+# ==============================================
+# SERVER CONFIGURATION
+# ==============================================
+
+NODE_ENV=development
+PORT=3000
+API_PREFIX=/api/v1
+LOG_LEVEL=info
+
+# ==============================================
+# DATABASE CONFIGURATION (MySQL)
+# ==============================================
+
+DATABASE_URL="mysql://root:{{DATABASE_PASSWORD}}@localhost:3306/{{DATABASE_NAME}}"
+
+
+# ==============================================
+# REDIS CONFIGURATION
+# ==============================================
+
+REDIS_HOST=localhost
+REDIS_PORT=6379
+REDIS_PASSWORD=
+REDIS_DB=0
+
+# ==============================================
+# JWT AUTHENTICATION
+# =============================================='
+
+# enter strong jwt secret in production !
+JWT_SECRET=123412341234123412341234123412341234123412341234123412341234
+JWT_ACCESS_EXPIRATION=15m
+JWT_REFRESH_EXPIRATION=7d
+JWT_ISSUER={{PROJECT_NAME}}
+
+# ==============================================
+# CORS CONFIGURATION
+# ==============================================
+
+CORS_ALLOWED_ORIGINS=http://localhost:5173,http://localhost:3000
+
+# ==============================================
+# FILE UPLOAD CONFIGURATION
+# ==============================================
+
+MAX_FILE_SIZE=10485760
+ALLOWED_FILE_TYPES=image/jpeg,image/png,image/webp,application/pdf
+UPLOAD_DIR=./uploads
+
+# ==============================================
+# RATE LIMITING
+# ==============================================
+
+RATE_LIMIT_MAX=100
+RATE_LIMIT_WINDOW=900000
+
+# ==============================================
+# DEVELOPMENT TOOLS
+# ==============================================
+
+PRISMA_QUERY_LOG=false
+SLOW_QUERY_THRESHOLD=1000
+
+# ==============================================
+# ADMIN SEED (Initial Setup)
+# ==============================================
+
+ADMIN_EMAIL=admin@{{PROJECT_NAME}}.dev
+ADMIN_PASSWORD=Admin123!

package/template/server/README.md

@@ -9,7 +9,6 @@
 - Pagination with filters
 - Rate limiting with Redis
 - Background job processing (BullMQ)
-- API documentation (Swagger/OpenAPI)
 - Comprehensive error handling
 - Request logging and monitoring
 - Health checks
@@ -22,7 +21,6 @@
 - **Validation**: Zod
 - **Authentication**: JWT (jsonwebtoken)
 - **Testing**: Vitest + Supertest
-- **Documentation**: Swagger/OpenAPI 3.0
 
 ## Prerequisites
 - Node.js 20 or higher
@@ -35,33 +33,43 @@
 # 1. Install dependencies
 npm install
 
-# 2. Copy environment variables
-cp .env.example .env
-# Edit .env and set required variables (DATABASE_URL, JWT_SECRET, etc.)
-
-# 3. Start Docker services (MySQL + Redis)
+# 2. Start Docker services (MySQL + Redis)
 docker-compose up -d
 
-# 4. Generate Prisma Client
-npm run prisma:generate
-
-# 5. Run database migrations
-npx prisma migrate dev --name init
+# 3. Initialize database (creates .env, waits for DB, runs migrations)
+npm run db:init
 
-# 6. Seed the database
+# 4. Seed the database
 npm run prisma:seed
 
-# 7. Start development server
+# 5. Start development server
 npm run dev
 ```
 
 Server will start at http://localhost:3000
 
-## API Documentation
+### Production Installation
+
+For production deployments, install only production dependencies:
+
+```bash
+# Install production dependencies only (faster, smaller)
+npm install --omit=dev
+
+# Generate Prisma Client
+npx prisma generate
+
+# Run migrations
+npx prisma migrate deploy
+```
+
+## API Endpoints
 
-Once running, visit:
-- Swagger UI: http://localhost:3000/docs
+Once running, you can access:
 - Health Check: http://localhost:3000/health
+- Auth endpoints: http://localhost:3000/api/v1/auth/*
+- Resources endpoints: http://localhost:3000/api/v1/resources/*
+- Admin endpoints: http://localhost:3000/api/v1/admin/*
 
 ## Available Scripts
 

package/template/server/package.json

@@ -3,7 +3,7 @@
   "version": "1.0.0",
   "description": "{{PROJECT_DESCRIPTION}}",
   "main": "dist/server.js",
-  "type": "commonjs",
+  "type": "module",
   "engines": {
     "node": ">=20.0.0"
   },
@@ -19,8 +19,9 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "env:setup": "node scripts/setup-env.js",
     "db:wait": "node scripts/wait-for-db.js",
-    "db:init": "npm run db:wait && npx prisma migrate dev --name init",
+    "db:init": "npm run env:setup && npm run db:wait && npx prisma migrate dev --name init",
     "prisma:generate": "prisma generate",
     "prisma:migrate": "prisma migrate dev",
     "prisma:migrate:deploy": "prisma migrate deploy",
@@ -48,8 +49,6 @@
     "@fastify/helmet": "^13.0.0",
     "@fastify/multipart": "^9.0.0",
     "@fastify/rate-limit": "^10.2.0",
-    "@fastify/swagger": "^9.4.0",
-    "@fastify/swagger-ui": "^5.2.0",
     "@prisma/client": "^6.2.0",
     "bcryptjs": "^2.4.3",
     "bullmq": "^5.34.0",
@@ -59,8 +58,7 @@
     "jsonwebtoken": "^9.0.2",
     "mysql2": "^3.11.5",
     "pino": "^9.6.0",
-    "zod": "^3.24.0",
-    "zod-to-json-schema": "^3.24.0"
+    "zod": "^3.24.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.0",
@@ -68,9 +66,9 @@
     "@types/jsonwebtoken": "^9.0.5",
     "@types/node": "^22.10.0",
     "@types/supertest": "^6.0.2",
+    "@vitest/coverage-v8": "^3.0.0",
     "pino-pretty": "^13.0.0",
     "prisma": "^6.2.0",
-    "@vitest/coverage-v8": "^3.0.0",
     "supertest": "^7.1.0",
     "tsc-alias": "^1.8.16",
     "tsx": "^4.19.0",

package/template/server/prisma/schema.prisma

@@ -8,7 +8,8 @@
 // ==============================================
 
 generator client {
-  provider = "prisma-client-js"
+  provider      = "prisma-client-js"
+  binaryTargets = ["native"]
 }
 
 datasource db {

package/template/server/scripts/setup-env.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+/**
+ * Setup environment file
+ * Copies .env.example to .env if .env doesn't exist
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const ROOT_DIR = path.resolve(__dirname, '..');
+const ENV_FILE = path.join(ROOT_DIR, '.env');
+const EXAMPLE_ENV_FILE = path.join(ROOT_DIR, '.env.example');
+
+function setupEnv() {
+  // Check if .env already exists
+  if (fs.existsSync(ENV_FILE)) {
+    console.log('✓ .env file already exists');
+    return;
+  }
+
+  // Check if .env.example exists
+  if (!fs.existsSync(EXAMPLE_ENV_FILE)) {
+    console.error('✗ .env.example file not found!');
+    console.error('  Please create a .env.example file first');
+    process.exit(1);
+  }
+
+  // Copy .env.example to .env
+  try {
+    fs.copyFileSync(EXAMPLE_ENV_FILE, ENV_FILE);
+    console.log('✓ Created .env file from .env.example');
+    console.log('');
+    console.log('⚠ IMPORTANT: Please update the following values in .env:');
+    console.log('  - DATABASE_URL (replace {{DATABASE_PASSWORD}} and {{DATABASE_NAME}})');
+    console.log('  - JWT_SECRET (use a strong secret in production)');
+    console.log('  - ADMIN_EMAIL and ADMIN_PASSWORD');
+    console.log('');
+  } catch (error) {
+    console.error('✗ Failed to create .env file:', error.message);
+    process.exit(1);
+  }
+}
+
+setupEnv();

package/template/server/scripts/wait-for-db.js

@@ -5,9 +5,9 @@
  * This script polls the database connection until it's available
  */
 
-const { createConnection } = require('mysql2/promise');
-const { config } = require('dotenv');
-const { resolve } = require('path');
+import { createConnection } from 'mysql2/promise';
+import { config } from 'dotenv';
+import { resolve } from 'path';
 
 // Load environment variables
 config({ path: resolve(process.cwd(), '.env') });

package/template/server/src/app.ts

@@ -7,7 +7,6 @@
  * @see /mnt/project/02-general-rules.md
  * @see /mnt/project/06-response-handling.md
  * @see /mnt/project/08-observability.md
- * @see /mnt/project/09-api-documentation-v2.md
  * @see /mnt/project/11-rate-limiting-v2.md
  */
 
@@ -19,7 +18,6 @@ import logger from '@/libs/logger';
 import { setupErrorHandler } from '@/libs/error-handler';
 import { registerSecurityPlugins } from '@/plugins/security.plugin';
 import { registerRateLimit } from '@/plugins/rate-limit.plugin';
-import { registerSwagger } from '@/plugins/swagger.plugin';
 import { registerRequestHooks } from '@/hooks/request-timing.hook';
 import { authenticateMiddleware } from '@/libs/auth/authenticate.middleware';
 import { healthRoutes } from '@/routes/health.routes';
@@ -47,7 +45,6 @@ const buildApp = async () => {
     // 1. Plugins
     await registerSecurityPlugins(app);
     await registerRateLimit(app);
-    await registerSwagger(app);
 
     // 2. Decorators
     app.decorate('authenticate', authenticateMiddleware);

package/template/server/src/config/env.ts

@@ -54,13 +54,6 @@ const envSchema = z.object({
     RATE_LIMIT_MAX: z.coerce.number().int().positive().default(100),
     RATE_LIMIT_WINDOW: z.coerce.number().int().positive().default(900000), // 15 minutes
 
-    // API Documentation Configuration
-    SWAGGER_ENABLED: z
-        .string()
-        .transform((val) => val === 'true')
-        .default('true'),
-    SWAGGER_ROUTE: z.string().default('/docs'),
-
     // Development Tools
     PRISMA_QUERY_LOG: z
         .string()

package/template/server/src/modules/admin/admin.routes.ts

@@ -1,7 +1,5 @@
 import { FastifyInstance } from 'fastify';
-import { toJsonSchema } from '@/libs/swagger-schemas';
 import * as adminController from './admin.controller';
-import * as schemas from './admin.schemas';
 
 /**
  * Admin Routes
@@ -13,12 +11,6 @@ export async function adminRoutes(app: FastifyInstance) {
      * List all users with pagination
      */
     app.get('/users', {
-        schema: {
-            description: 'List all users (admin only)',
-            tags: ['admin'],
-            querystring: toJsonSchema(schemas.ListUsersSchema, 'ListUsersSchema'),
-            security: [{ bearerAuth: [] }],
-        },
         preHandler: [app.authenticate, app.requireAdmin()],
         handler: adminController.listAllUsers,
     });
@@ -28,12 +20,6 @@ export async function adminRoutes(app: FastifyInstance) {
      * Get user details
      */
     app.get('/users/:id', {
-        schema: {
-            description: 'Get user by ID (admin only)',
-            tags: ['admin'],
-            params: toJsonSchema(schemas.UserIdSchema, 'UserIdSchema'),
-            security: [{ bearerAuth: [] }],
-        },
         preHandler: [app.authenticate, app.requireAdmin()],
         handler: adminController.getUserById,
     });
@@ -43,12 +29,6 @@ export async function adminRoutes(app: FastifyInstance) {
      * Delete user
      */
     app.delete('/users/:id', {
-        schema: {
-            description: 'Delete user (admin only)',
-            tags: ['admin'],
-            params: toJsonSchema(schemas.UserIdSchema, 'UserIdSchema'),
-            security: [{ bearerAuth: [] }],
-        },
         preHandler: [app.authenticate, app.requireAdmin()],
         handler: adminController.deleteUser,
     });
@@ -58,13 +38,6 @@ export async function adminRoutes(app: FastifyInstance) {
      * Change user role
      */
     app.post('/users/:id/change-role', {
-        schema: {
-            description: 'Change user role (admin only)',
-            tags: ['admin'],
-            params: toJsonSchema(schemas.UserIdSchema, 'UserIdSchema'),
-            body: toJsonSchema(schemas.ChangeRoleSchema, 'ChangeRoleSchema'),
-            security: [{ bearerAuth: [] }],
-        },
         preHandler: [app.authenticate, app.requireAdmin()],
         handler: adminController.changeUserRole,
     });
@@ -74,12 +47,6 @@ export async function adminRoutes(app: FastifyInstance) {
      * Manually verify user email
      */
     app.post('/users/:id/verify-email', {
-        schema: {
-            description: 'Verify user email manually (admin only)',
-            tags: ['admin'],
-            params: toJsonSchema(schemas.UserIdSchema, 'UserIdSchema'),
-            security: [{ bearerAuth: [] }],
-        },
         preHandler: [app.authenticate, app.requireAdmin()],
         handler: adminController.verifyUserEmail,
     });
@@ -89,11 +56,6 @@ export async function adminRoutes(app: FastifyInstance) {
      * Get system statistics
      */
     app.get('/stats', {
-        schema: {
-            description: 'Get system statistics (admin only)',
-            tags: ['admin'],
-            security: [{ bearerAuth: [] }],
-        },
         preHandler: [app.authenticate, app.requireAdmin()],
         handler: adminController.getSystemStats,
     });