create-tigra 1.0.7 → 2.0.0

package/bin/create-tigra.js

@@ -1,309 +1,242 @@
-#!/usr/bin/env node
-
-import { Command } from 'commander';
-import prompts from 'prompts';
-import chalk from 'chalk';
-import ora from 'ora';
-import fs from 'fs-extra';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// ==============================================
-// Case Transformation Utilities
-// ==============================================
-
-function toKebabCase(str) {
-    return str
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-|-$/g, '');
-}
-
-function toSnakeCase(str) {
-    return str
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '_')
-        .replace(/^_|_$/g, '');
-}
-
-function toTitleCase(str) {
-    return str
-        .replace(/[^a-z0-9]+/gi, ' ')
-        .split(' ')
-        .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
-        .join(' ');
-}
-
-// ==============================================
-// Template Variable Replacement
-// ==============================================
-
-function generateSecureSecret(length = 32) {
-    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*';
-    let result = '';
-    for (let i = 0; i < length; i++) {
-        result += chars.charAt(Math.floor(Math.random() * chars.length));
-    }
-    return result;
-}
-
-function replaceTemplateVariables(content, config) {
-    const replacements = {
-        '{{PROJECT_NAME}}': config.projectName,
-        '{{PROJECT_NAME_SNAKE}}': config.projectNameSnake,
-        '{{PROJECT_DISPLAY_NAME}}': config.projectDisplayName,
-        '{{PROJECT_DESCRIPTION}}': config.projectDescription,
-        '{{DATABASE_NAME}}': config.databaseName,
-        '{{DATABASE_USER}}': config.databaseUser,
-        '{{DATABASE_PASSWORD}}': config.databasePassword,
-        '{{AUTHOR_NAME}}': config.authorName,
-        '{{JWT_SECRET}}': config.jwtSecret,
-    };
-
-    let result = content;
-    for (const [key, value] of Object.entries(replacements)) {
-        result = result.split(key).join(value);
-    }
-
-    return result;
-}
-
-// ==============================================
-// Files to Process (relative to project root)
-// ==============================================
-
-const filesToProcess = [
-    // Root files
-    'CLAUDE.md',
-    // Server files
-    'server/package.json',
-    'server/.env.example',
-    'server/docker-compose.yml',
-    'server/README.md',
-    'server/src/config/env.ts',
-    'server/prisma/schema.prisma',
-    'server/Tigra-API.postman_collection.json',
-];
-
-// Files/folders to exclude from template
-const excludePatterns = [
-    'node_modules',
-    'dist',
-    '.git',
-    'package-lock.json',
-    'pnpm-lock.yaml',
-    'yarn.lock',
-    'coverage',
-    'build-errors.txt',
-    '.env.local',
-    '.env',
-    '*.tsbuildinfo',
-    'tsconfig.build.tsbuildinfo',
-    '.DS_Store',
-    'Thumbs.db',
-];
-
-// ==============================================
-// Main CLI
-// ==============================================
-
-const program = new Command();
-
-program
-    .name('create-tigra')
-    .description('Create a production-ready Fastify + TypeScript + Prisma API server')
-    .version('1.0.0')
-    .argument('[project-name]', 'Name of the project')
-    .option('-y, --yes', 'Skip prompts and use defaults')
-    .action(async (projectNameArg, options) => {
-        console.log();
-        console.log(chalk.bold.cyan('  Create Tigra'));
-        console.log(chalk.gray('  Production-ready Fastify + TypeScript + Prisma'));
-        console.log();
-
-        let projectName = projectNameArg;
-
-        // If no project name provided, prompt for it
-        if (!projectName) {
-            const response = await prompts({
-                type: 'text',
-                name: 'projectName',
-                message: 'Project name:',
-                initial: 'my-project',
-                validate: (value) =>
-                    /^[a-z][a-z0-9-]*$/.test(value) ||
-                    'Must start with letter, lowercase letters, numbers, and hyphens only',
-            });
-
-            if (!response.projectName) {
-                console.log(chalk.red('Cancelled.'));
-                process.exit(1);
-            }
-            projectName = response.projectName;
-        }
-
-        // Validate project name
-        projectName = toKebabCase(projectName);
-
-        // Check if directory exists
-        const targetDir = path.join(process.cwd(), projectName);
-        if (fs.existsSync(targetDir)) {
-            console.log(chalk.red(`Error: Directory "${projectName}" already exists.`));
-            process.exit(1);
-        }
-
-        // Gather additional info (or use defaults)
-        let config;
-        if (options.yes) {
-            config = {
-                projectName,
-                projectNameSnake: toSnakeCase(projectName),
-                projectDisplayName: toTitleCase(projectName),
-                projectDescription: 'A production-ready REST API server',
-                databaseName: toSnakeCase(projectName) + '_db',
-                databaseUser: 'root',
-                databasePassword: 'password',
-                authorName: '',
-                jwtSecret: generateSecureSecret(48),
-            };
-        } else {
-            const answers = await prompts([
-                {
-                    type: 'text',
-                    name: 'projectDisplayName',
-                    message: 'Display name:',
-                    initial: toTitleCase(projectName),
-                },
-                {
-                    type: 'text',
-                    name: 'projectDescription',
-                    message: 'Description (optional):',
-                    initial: '',
-                },
-                {
-                    type: 'text',
-                    name: 'authorName',
-                    message: 'Author name (optional):',
-                    initial: '',
-                },
-            ]);
-
-            if (!answers.projectDisplayName) {
-                console.log(chalk.red('Cancelled.'));
-                process.exit(1);
-            }
-
-            config = {
-                projectName,
-                projectNameSnake: toSnakeCase(projectName),
-                projectDisplayName: answers.projectDisplayName,
-                projectDescription: answers.projectDescription || '',
-                databaseName: toSnakeCase(projectName) + '_db',
-                databaseUser: 'root',
-                databasePassword: 'password',
-                authorName: answers.authorName || '',
-                jwtSecret: generateSecureSecret(48),
-            };
-        }
-
-        // Copy template
-        const spinner = ora('Creating project...').start();
-
-        try {
-            const templateDir = path.join(__dirname, '..', 'template');
-
-            // Filter function to exclude unwanted files/folders
-            const filterFunc = (src) => {
-                const relativePath = path.relative(templateDir, src);
-                const basename = path.basename(src);
-
-                // Always include the root
-                if (!relativePath) return true;
-
-                // Special case: ALWAYS include .env.example
-                if (basename === '.env.example') {
-                    return true;
-                }
-
-                // Special case: exclude .env (but not .env.example which was already handled)
-                if (basename === '.env') {
-                    return false;
-                }
-
-                // Check against exclude patterns
-                return !excludePatterns.some(
-                    (pattern) =>
-                        relativePath === pattern ||
-                        relativePath.includes(`${path.sep}${pattern}`) ||
-                        relativePath.includes(`${pattern}${path.sep}`) ||
-                        relativePath.startsWith(`${pattern}${path.sep}`)
-                );
-            };
-
-            // Copy entire template directory to target
-            await fs.copy(templateDir, targetDir, { filter: filterFunc });
-
-            spinner.text = 'Replacing template variables...';
-
-            // Process files with template variables
-            for (const file of filesToProcess) {
-                const filePath = path.join(targetDir, file);
-                if (await fs.pathExists(filePath)) {
-                    const content = await fs.readFile(filePath, 'utf8');
-                    const replaced = replaceTemplateVariables(content, config);
-                    await fs.writeFile(filePath, replaced, 'utf8');
-                }
-            }
-
-            spinner.succeed('Project created successfully!');
-
-            // Print next steps
-            console.log();
-            console.log(chalk.green(`  Done! Created ${chalk.bold(projectName)}`));
-            console.log();
-            console.log('  Project structure:');
-            console.log(chalk.gray(`    ${projectName}/`));
-            console.log(chalk.gray('    ├── server/        # Backend API'));
-            console.log(chalk.gray('    ├── .agent/        # AI agent rules'));
-            console.log(chalk.gray('    ├── .claude/       # Claude Code rules'));
-            console.log(chalk.gray('    ├── .cursor/       # Cursor IDE rules'));
-            console.log(chalk.gray('    └── CLAUDE.md      # Project rules'));
-            console.log();
-            console.log('  Next steps:');
-            console.log();
-            console.log(chalk.cyan(`    cd ${projectName}/server`));
-            console.log(chalk.cyan('    npm install'));
-            console.log();
-            console.log(chalk.yellow('  Start Docker services (Docker must be running):'));
-            console.log(chalk.cyan('    docker-compose up -d'));
-            console.log();
-            console.log(chalk.yellow('  Initialize database (waits for MySQL to be ready):'));
-            console.log(chalk.cyan('    npm run db:init                     # Waits for DB + runs migration'));
-            console.log(chalk.cyan('    npm run prisma:seed                 # Seed database with admin + sample data'));
-            console.log();
-            console.log(chalk.yellow('  Build and start:'));
-            console.log(chalk.cyan('    npm run build                       # Build the project'));
-            console.log(chalk.cyan('    npm run dev                         # Start development server'));
-            console.log();
-            console.log(chalk.yellow('  Note on Docker:'));
-            console.log(chalk.gray(`    Containers will be named: ${projectName}-mysql, ${projectName}-redis, etc.`));
-            console.log(chalk.gray('    Default ports: 3306 (MySQL), 6379 (Redis), 8080 (phpMyAdmin), 8081 (Redis UI)'));
-            console.log(chalk.gray('    If ports conflict, edit docker-compose.yml or stop other containers first.'));
-            console.log();
-            console.log(chalk.gray('  URLs after starting:'));
-            console.log(chalk.gray('    API Server:  http://localhost:3000'));
-            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();
-        } catch (error) {
-            spinner.fail('Failed to create project');
-            console.error(chalk.red(error.message));
-            process.exit(1);
-        }
-    });
-
-program.parse();
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import prompts from 'prompts';
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import crypto from 'crypto';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const TEMPLATE_DIR = path.join(__dirname, '..', 'template');
+
+// Files that contain template variables and need replacement
+const FILES_TO_REPLACE = [
+  'server/package.json',
+  'server/.env.example',
+  'server/docker-compose.yml',
+  'client/package.json',
+  'client/.env.example',
+];
+
+// Directories/files to skip when copying
+const SKIP_PATTERNS = [
+  'node_modules',
+  '.next',
+  'dist',
+  'out',
+  '.env',
+  '.env.local',
+  '.env.*.local',
+  'package-lock.json',
+  'pnpm-lock.yaml',
+  'yarn.lock',
+];
+
+function toKebabCase(str) {
+  return str
+    .toLowerCase()
+    .replace(/[^a-z0-9-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+
+function toSnakeCase(str) {
+  return str.replace(/-/g, '_');
+}
+
+function toTitleCase(str) {
+  return str
+    .split('-')
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(' ');
+}
+
+function validateProjectName(name) {
+  if (!name || name.trim().length === 0) {
+    return 'Project name cannot be empty';
+  }
+  const kebab = toKebabCase(name);
+  if (kebab.length === 0) {
+    return 'Project name must contain at least one alphanumeric character';
+  }
+  if (kebab.length > 214) {
+    return 'Project name is too long (max 214 characters)';
+  }
+  return true;
+}
+
+function shouldSkip(filePath) {
+  const parts = filePath.split(path.sep);
+  return parts.some((part) =>
+    SKIP_PATTERNS.some((pattern) => {
+      if (pattern.includes('*')) {
+        const regex = new RegExp('^' + pattern.replace(/\./g, '\\.').replace(/\*/g, '.*') + '$');
+        return regex.test(part);
+      }
+      return part === pattern;
+    })
+  );
+}
+
+async function copyTemplate(templateDir, targetDir) {
+  const entries = await fs.readdir(templateDir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(templateDir, entry.name);
+    const relativePath = path.relative(TEMPLATE_DIR, srcPath);
+
+    if (shouldSkip(relativePath)) {
+      continue;
+    }
+
+    // Handle dotfile renaming: gitignore -> .gitignore, _claude -> .claude
+    let destName = entry.name;
+    if (entry.name === 'gitignore') destName = '.gitignore';
+    if (entry.name === '_claude') destName = '.claude';
+
+    const destPath = path.join(targetDir, destName);
+
+    if (entry.isDirectory()) {
+      await fs.ensureDir(destPath);
+      await copyTemplate(srcPath, destPath);
+    } else {
+      await fs.copy(srcPath, destPath);
+    }
+  }
+}
+
+function replaceVariables(content, variables) {
+  let result = content;
+  for (const [key, value] of Object.entries(variables)) {
+    result = result.replaceAll(`{{${key}}}`, value);
+  }
+  return result;
+}
+
+async function main() {
+  const program = new Command();
+
+  program
+    .name('create-tigra')
+    .description('Create a production-ready full-stack app with Next.js + Fastify + Prisma + Redis')
+    .version('2.0.0')
+    .argument('[project-name]', 'Name for your new project')
+    .action(async (projectNameArg) => {
+      console.log();
+      console.log(chalk.bold('  Create Tigra') + chalk.dim(' v2.0.0'));
+      console.log();
+
+      let projectName = projectNameArg;
+
+      if (!projectName) {
+        const response = await prompts(
+          {
+            type: 'text',
+            name: 'projectName',
+            message: 'What is your project name?',
+            validate: validateProjectName,
+          },
+          {
+            onCancel: () => {
+              console.log(chalk.red('\n  Cancelled.\n'));
+              process.exit(1);
+            },
+          }
+        );
+        projectName = response.projectName;
+      }
+
+      // Validate and normalize
+      const validation = validateProjectName(projectName);
+      if (validation !== true) {
+        console.error(chalk.red(`\n  ${validation}\n`));
+        process.exit(1);
+      }
+
+      projectName = toKebabCase(projectName);
+
+      const targetDir = path.resolve(process.cwd(), projectName);
+
+      // Check if directory exists and is non-empty
+      if (await fs.pathExists(targetDir)) {
+        const files = await fs.readdir(targetDir);
+        if (files.length > 0) {
+          console.error(chalk.red(`\n  Directory "${projectName}" already exists and is not empty.\n`));
+          process.exit(1);
+        }
+      }
+
+      // Derive all variables
+      const variables = {
+        PROJECT_NAME: projectName,
+        PROJECT_NAME_SNAKE: toSnakeCase(projectName),
+        PROJECT_DISPLAY_NAME: toTitleCase(projectName),
+        DATABASE_NAME: `${toSnakeCase(projectName)}_db`,
+        JWT_SECRET: crypto.randomBytes(48).toString('hex'),
+      };
+
+      // Copy template
+      const spinner = ora('Scaffolding project...').start();
+
+      try {
+        await fs.ensureDir(targetDir);
+        await copyTemplate(TEMPLATE_DIR, targetDir);
+
+        // Replace template variables in specific files
+        for (const filePath of FILES_TO_REPLACE) {
+          const fullPath = path.join(targetDir, filePath);
+          if (await fs.pathExists(fullPath)) {
+            const content = await fs.readFile(fullPath, 'utf-8');
+            const replaced = replaceVariables(content, variables);
+            await fs.writeFile(fullPath, replaced, 'utf-8');
+          }
+        }
+
+        spinner.succeed('Project scaffolded successfully!');
+      } catch (error) {
+        spinner.fail('Failed to scaffold project');
+        console.error(chalk.red(`\n  ${error.message}\n`));
+        process.exit(1);
+      }
+
+      // Print next steps
+      console.log();
+      console.log(chalk.green.bold(`  Success!`) + ` Created ${chalk.cyan(projectName)} at ${chalk.dim(targetDir)}`);
+      console.log();
+      console.log(chalk.bold('  Next steps:'));
+      console.log();
+      console.log(chalk.cyan('  1.') + ' Start infrastructure:');
+      console.log(chalk.dim(`     cd ${projectName}/server`));
+      console.log(chalk.dim('     docker compose up -d'));
+      console.log();
+      console.log(chalk.cyan('  2.') + ' Install server dependencies & set up database:');
+      console.log(chalk.dim('     npm install'));
+      console.log(chalk.dim('     cp .env.example .env'));
+      console.log(chalk.dim('     npm run prisma:generate'));
+      console.log(chalk.dim('     npm run prisma:migrate:dev -- --name init'));
+      console.log();
+      console.log(chalk.cyan('  3.') + ' Start the server:');
+      console.log(chalk.dim('     npm run dev'));
+      console.log();
+      console.log(chalk.cyan('  4.') + ` In a ${chalk.bold('new terminal')}, set up the client:`);
+      console.log(chalk.dim(`     cd ${projectName}/client`));
+      console.log(chalk.dim('     npm install'));
+      console.log(chalk.dim('     cp .env.example .env'));
+      console.log(chalk.dim('     npm run dev'));
+      console.log();
+      console.log(chalk.dim('  Server running at: ') + chalk.cyan('http://localhost:8000'));
+      console.log(chalk.dim('  Client running at: ') + chalk.cyan('http://localhost:3000'));
+      console.log();
+      console.log(chalk.dim('  Happy coding!'));
+      console.log();
+    });
+
+  program.parse();
+}
+
+main();

package/package.json

@@ -1,41 +1,49 @@
-{
-  "name": "create-tigra",
-  "version": "1.0.7",
-  "type": "module",
-  "description": "Create a production-ready Fastify + TypeScript + Prisma API server",
-  "keywords": [
-    "create",
-    "generator",
-    "scaffold",
-    "fastify",
-    "typescript",
-    "prisma",
-    "api",
-    "rest",
-    "boilerplate",
-    "starter"
-  ],
-  "author": "",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Makinloot/create-tigra.git"
-  },
-  "bin": {
-    "create-tigra": "bin/create-tigra.js"
-  },
-  "files": [
-    "bin",
-    "template"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "fs-extra": "^11.2.0",
-    "ora": "^8.0.1",
-    "prompts": "^2.4.2"
-  }
-}
+{
+  "name": "create-tigra",
+  "version": "2.0.0",
+  "type": "module",
+  "description": "Create a production-ready full-stack app with Next.js 16 + Fastify 5 + Prisma + Redis",
+  "bin": {
+    "create-tigra": "bin/create-tigra.js"
+  },
+  "files": [
+    "bin",
+    "template"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "create",
+    "generator",
+    "scaffold",
+    "fullstack",
+    "nextjs",
+    "fastify",
+    "typescript",
+    "prisma",
+    "redis",
+    "boilerplate",
+    "starter",
+    "react",
+    "tailwind",
+    "shadcn"
+  ],
+  "author": "seed977",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blessandsoul/create-tigra.git"
+  },
+  "bugs": {
+    "url": "https://github.com/blessandsoul/create-tigra/issues"
+  },
+  "homepage": "https://github.com/blessandsoul/create-tigra#readme",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "fs-extra": "^11.3.0",
+    "ora": "^8.2.0",
+    "prompts": "^2.4.2"
+  }
+}