stackkit-cli 0.1.0

package/dist/utils/logger.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+class Logger {
+    spinner = null;
+    info(message) {
+        console.log(chalk_1.default.blue('ℹ'), message);
+    }
+    success(message) {
+        console.log(chalk_1.default.green('✔'), message);
+    }
+    error(message) {
+        console.log(chalk_1.default.red('✖'), message);
+    }
+    warn(message) {
+        console.log(chalk_1.default.yellow('⚠'), message);
+    }
+    log(message) {
+        console.log(message);
+    }
+    newLine() {
+        console.log();
+    }
+    startSpinner(text) {
+        this.spinner = (0, ora_1.default)(text).start();
+        return this.spinner;
+    }
+    stopSpinner(success = true, text) {
+        if (this.spinner) {
+            if (success) {
+                this.spinner.succeed(text);
+            }
+            else {
+                this.spinner.fail(text);
+            }
+            this.spinner = null;
+        }
+    }
+    updateSpinner(text) {
+        if (this.spinner) {
+            this.spinner.text = text;
+        }
+    }
+    header(text) {
+        console.log(chalk_1.default.bold.cyan(text));
+    }
+    footer() {
+        console.log();
+    }
+}
+exports.Logger = Logger;
+exports.logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,8CAA+B;AAE/B,MAAa,MAAM;IACT,OAAO,GAAe,IAAI,CAAC;IAEnC,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,GAAG,CAAC,OAAe;QACjB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,YAAY,CAAC,IAAY;QACvB,IAAI,CAAC,OAAO,GAAG,IAAA,aAAG,EAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,WAAW,CAAC,OAAO,GAAG,IAAI,EAAE,IAAa;QACvC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;CACF;AAxDD,wBAwDC;AAEY,QAAA,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/utils/package-manager.d.ts

@@ -0,0 +1,6 @@
+export type PackageManager = 'npm' | 'yarn' | 'pnpm';
+export declare function detectPackageManager(cwd: string): Promise<PackageManager>;
+export declare function installDependencies(cwd: string, pm: PackageManager, dev?: boolean): Promise<void>;
+export declare function addDependencies(cwd: string, pm: PackageManager, packages: string[], dev?: boolean): Promise<void>;
+export declare function initGit(cwd: string): Promise<void>;
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/utils/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAO/E;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,cAAc,EAClB,GAAG,UAAQ,GACV,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,UAAQ,GACV,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxD"}

package/dist/utils/package-manager.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPackageManager = detectPackageManager;
+exports.installDependencies = installDependencies;
+exports.addDependencies = addDependencies;
+exports.initGit = initGit;
+const detect_package_manager_1 = require("detect-package-manager");
+const execa_1 = __importDefault(require("execa"));
+const logger_1 = require("./logger");
+async function detectPackageManager(cwd) {
+    try {
+        const pm = await (0, detect_package_manager_1.detect)({ cwd });
+        return pm;
+    }
+    catch {
+        return 'npm';
+    }
+}
+async function installDependencies(cwd, pm, dev = false) {
+    const spinner = logger_1.logger.startSpinner(`Installing dependencies with ${pm}...`);
+    try {
+        const args = [];
+        if (pm === 'npm') {
+            args.push('install');
+        }
+        else if (pm === 'yarn') {
+            args.push('install');
+        }
+        else if (pm === 'pnpm') {
+            args.push('install');
+        }
+        await (0, execa_1.default)(pm, args, { cwd, stdio: 'pipe' });
+        spinner.succeed(`Dependencies installed successfully`);
+    }
+    catch (error) {
+        spinner.fail(`Failed to install dependencies`);
+        throw error;
+    }
+}
+async function addDependencies(cwd, pm, packages, dev = false) {
+    if (packages.length === 0)
+        return;
+    const spinner = logger_1.logger.startSpinner(`Adding ${dev ? 'dev ' : ''}dependencies: ${packages.join(', ')}...`);
+    try {
+        const args = [];
+        if (pm === 'npm') {
+            args.push('install', dev ? '--save-dev' : '--save', ...packages);
+        }
+        else if (pm === 'yarn') {
+            args.push('add', dev ? '--dev' : '', ...packages);
+        }
+        else if (pm === 'pnpm') {
+            args.push('add', dev ? '-D' : '', ...packages);
+        }
+        await (0, execa_1.default)(pm, args.filter(Boolean), { cwd, stdio: 'pipe' });
+        spinner.succeed(`Dependencies added successfully`);
+    }
+    catch (error) {
+        spinner.fail(`Failed to add dependencies`);
+        throw error;
+    }
+}
+async function initGit(cwd) {
+    const spinner = logger_1.logger.startSpinner('Initializing git repository...');
+    try {
+        await (0, execa_1.default)('git', ['init'], { cwd });
+        await (0, execa_1.default)('git', ['add', '.'], { cwd });
+        await (0, execa_1.default)('git', ['commit', '-m', 'Initial commit from StackKit'], { cwd });
+        spinner.succeed('Git repository initialized');
+    }
+    catch (error) {
+        spinner.fail('Failed to initialize git repository');
+        // Don't throw - git init is optional
+    }
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/utils/package-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../src/utils/package-manager.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "stackkit-cli",
+  "version": "0.1.0",
+  "description": "CLI for StackKit - Production-ready project generator and module system",
+  "main": "dist/index.js",
+  "bin": {
+    "stackkit": "./bin/stackkit.js"
+  },
+  "type": "commonjs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tariqul420/stackkit.git",
+    "directory": "apps/stackkit-cli"
+  },
+  "homepage": "https://github.com/tariqul420/stackkit#readme",
+  "bugs": {
+    "url": "https://github.com/tariqul420/stackkit/issues"
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "cli",
+    "generator",
+    "nextjs",
+    "template"
+  ],
+  "author": "Your Name",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "inquirer": "^9.2.12",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "fs-extra": "^11.2.0",
+    "execa": "^5.1.1",
+    "validate-npm-package-name": "^5.0.0",
+    "detect-package-manager": "^3.0.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.0",
+    "@types/validate-npm-package-name": "^4.0.2",
+    "typescript": "^5.3.3"
+  }
+}

package/src/commands/add.ts

@@ -0,0 +1,261 @@
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import inquirer from 'inquirer';
+import path from 'path';
+import { CreateFilePatch, ModuleMetadata } from '../types';
+import { detectProjectInfo, getLibPath, getRouterBasePath } from '../utils/detect';
+import { addEnvVariables } from '../utils/env-editor';
+import { createFile, fileExists } from '../utils/files';
+import { logger } from '../utils/logger';
+import { addDependencies } from '../utils/package-manager';
+
+interface AddOptions {
+  provider?: string;
+  force?: boolean;
+  dryRun?: boolean;
+  install?: boolean;
+}
+
+export async function addCommand(module: string, options: AddOptions): Promise<void> {
+  try {
+    const projectRoot = process.cwd();
+
+    // Detect project info
+    const spinner = logger.startSpinner('Detecting project...');
+    const projectInfo = await detectProjectInfo(projectRoot);
+    spinner.succeed(
+      `Detected ${projectInfo.framework} (${projectInfo.router} router, ${projectInfo.language})`
+    );
+
+    // Load module metadata
+    const modulesDir = path.join(__dirname, '..', '..', '..', '..', 'modules');
+    const moduleMetadata = await loadModuleMetadata(modulesDir, module, options.provider);
+
+    if (!moduleMetadata) {
+      logger.error(`Module "${module}" not found`);
+      process.exit(1);
+    }
+
+    // Check if framework is supported
+    if (!moduleMetadata.supportedFrameworks.includes(projectInfo.framework)) {
+      logger.error(
+        `Module "${module}" does not support ${projectInfo.framework}. Supported: ${moduleMetadata.supportedFrameworks.join(', ')}`
+      );
+      process.exit(1);
+    }
+
+    // Check for conflicts
+    if (module === 'auth' && projectInfo.hasAuth && !options.force) {
+      logger.warn('Auth library already detected in this project');
+      const { proceed } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'proceed',
+          message: 'Continue anyway? (use --force to skip this prompt)',
+          default: false,
+        },
+      ]);
+
+      if (!proceed) {
+        logger.info('Cancelled');
+        process.exit(0);
+      }
+    }
+
+    if (options.dryRun) {
+      logger.warn('Dry run mode - no changes will be made');
+      logger.newLine();
+    }
+
+    // Apply module patches
+    await applyModulePatches(projectRoot, projectInfo, moduleMetadata, modulesDir, module, options);
+
+    // Add dependencies
+    if (Object.keys(moduleMetadata.dependencies).length > 0 && options.install !== false) {
+      const deps = Object.entries(moduleMetadata.dependencies).map(
+        ([name, version]) => `${name}@${version}`
+      );
+
+      if (!options.dryRun) {
+        await addDependencies(projectRoot, projectInfo.packageManager, deps, false);
+      } else {
+        logger.info(`Would add dependencies: ${deps.join(', ')}`);
+      }
+    }
+
+    // Add dev dependencies
+    if (
+      moduleMetadata.devDependencies &&
+      Object.keys(moduleMetadata.devDependencies).length > 0 &&
+      options.install !== false
+    ) {
+      const devDeps = Object.entries(moduleMetadata.devDependencies).map(
+        ([name, version]) => `${name}@${version}`
+      );
+
+      if (!options.dryRun) {
+        await addDependencies(projectRoot, projectInfo.packageManager, devDeps, true);
+      } else {
+        logger.info(`Would add dev dependencies: ${devDeps.join(', ')}`);
+      }
+    }
+
+    // Add environment variables
+    if (moduleMetadata.envVars.length > 0) {
+      if (!options.dryRun) {
+        await addEnvVariables(projectRoot, moduleMetadata.envVars, { force: options.force });
+      } else {
+        logger.log(`  ${chalk.dim('~')} .env.example`);
+      }
+    }
+
+    logger.newLine();
+    logger.success(`Added ${chalk.bold(moduleMetadata.displayName)}`);
+    logger.newLine();
+
+    // Print next steps
+    if (moduleMetadata.envVars.some((v) => v.required)) {
+      logger.log('Next: Fill in environment variables in .env');
+    }
+    logger.newLine();
+  } catch (error) {
+    logger.error(`Failed to add module: ${(error as Error).message}`);
+    if (error instanceof Error && error.stack) {
+      logger.log(chalk.gray(error.stack));
+    }
+    process.exit(1);
+  }
+}
+
+async function loadModuleMetadata(
+  modulesDir: string,
+  moduleName: string,
+  provider?: string
+): Promise<ModuleMetadata | null> {
+  if (!(await fs.pathExists(modulesDir))) {
+    return null;
+  }
+
+  // Try to find module in any category
+  const categories = await fs.readdir(modulesDir);
+
+  for (const category of categories) {
+    const categoryPath = path.join(modulesDir, category);
+    const stat = await fs.stat(categoryPath);
+
+    if (!stat.isDirectory()) continue;
+
+    // Get all modules in this category
+    const moduleDirs = await fs.readdir(categoryPath);
+
+    for (const moduleDir of moduleDirs) {
+      const modulePath = path.join(categoryPath, moduleDir);
+      const moduleStat = await fs.stat(modulePath);
+
+      if (!moduleStat.isDirectory()) continue;
+
+      const metadataPath = path.join(modulePath, 'module.json');
+
+      if (await fs.pathExists(metadataPath)) {
+        const metadata = await fs.readJSON(metadataPath);
+
+        // Match by module name or provider
+        if (metadata.name === moduleName || (provider && moduleDir === provider)) {
+          return metadata;
+        }
+      }
+    }
+  }
+
+  return null;
+}
+
+async function applyModulePatches(
+  projectRoot: string,
+  projectInfo: any,
+  moduleMetadata: ModuleMetadata,
+  modulesDir: string,
+  moduleName: string,
+  options: AddOptions
+): Promise<void> {
+  const moduleBasePath = await findModulePath(modulesDir, moduleName, options.provider);
+
+  if (!moduleBasePath) {
+    throw new Error('Module files not found');
+  }
+
+  for (const patch of moduleMetadata.patches) {
+    if (patch.type === 'create-file') {
+      const filePatch = patch as CreateFilePatch;
+
+      // Check conditions
+      if (filePatch.condition) {
+        if (filePatch.condition.router && filePatch.condition.router !== projectInfo.router) {
+          continue; // Skip this patch
+        }
+        if (filePatch.condition.language && filePatch.condition.language !== projectInfo.language) {
+          continue; // Skip this patch
+        }
+      }
+
+      const sourceFile = path.join(moduleBasePath, 'files', filePatch.source);
+      let destFile = path.join(projectRoot, filePatch.destination);
+
+      // Replace placeholders in destination
+      destFile = destFile
+        .replace('{{router}}', getRouterBasePath(projectInfo))
+        .replace('{{lib}}', getLibPath(projectInfo));
+
+      if (!options.dryRun) {
+        if (await fileExists(sourceFile)) {
+          const content = await fs.readFile(sourceFile, 'utf-8');
+          await createFile(destFile, content, { force: options.force });
+          const relativePath = path.relative(projectRoot, destFile);
+          logger.log(`  ${chalk.green('+')} ${relativePath}`);
+        } else {
+          logger.warn(`Source file not found: ${filePatch.source}`);
+        }
+      } else {
+        const relativePath = path.relative(projectRoot, destFile);
+        logger.log(`  ${chalk.dim('+')} ${relativePath}`);
+      }
+    }
+  }
+}
+
+async function findModulePath(
+  modulesDir: string,
+  moduleName: string,
+  provider?: string
+): Promise<string | null> {
+  const categories = await fs.readdir(modulesDir);
+
+  for (const category of categories) {
+    const categoryPath = path.join(modulesDir, category);
+    const stat = await fs.stat(categoryPath);
+
+    if (!stat.isDirectory()) continue;
+
+    const moduleDirs = await fs.readdir(categoryPath);
+
+    for (const moduleDir of moduleDirs) {
+      const modulePath = path.join(categoryPath, moduleDir);
+      const moduleStat = await fs.stat(modulePath);
+
+      if (!moduleStat.isDirectory()) continue;
+
+      const metadataPath = path.join(modulePath, 'module.json');
+
+      if (await fs.pathExists(metadataPath)) {
+        const metadata = await fs.readJSON(metadataPath);
+
+        // Match by module name or provider
+        if (metadata.name === moduleName || (provider && moduleDir === provider)) {
+          return modulePath;
+        }
+      }
+    }
+  }
+
+  return null;
+}

package/src/commands/init.ts

@@ -0,0 +1,182 @@
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import inquirer from 'inquirer';
+import path from 'path';
+import validateNpmPackageName from 'validate-npm-package-name';
+import { TemplateMetadata } from '../types';
+import { copyTemplate } from '../utils/files';
+import { logger } from '../utils/logger';
+import { initGit, installDependencies, PackageManager } from '../utils/package-manager';
+
+interface InitOptions {
+  template?: string;
+  pm?: PackageManager;
+  install?: boolean;
+  git?: boolean;
+  yes?: boolean;
+}
+
+export async function initCommand(
+  projectName: string | undefined,
+  options: InitOptions
+): Promise<void> {
+  try {
+    // Validate package manager option
+    if (options.pm && !['npm', 'yarn', 'pnpm'].includes(options.pm)) {
+      logger.error(`Invalid package manager: ${options.pm}. Use npm, yarn, or pnpm.`);
+      process.exit(1);
+    }
+
+    // Get available templates
+    const templatesDir = path.join(__dirname, '..', '..', '..', '..', 'templates');
+    const templates = await getAvailableTemplates(templatesDir);
+
+    if (templates.length === 0) {
+      logger.error('No templates found');
+      process.exit(1);
+    }
+
+    // Prompt for project details if not using --yes
+    let answers: {
+      projectName: string;
+      template: string;
+      packageManager: PackageManager;
+      install: boolean;
+      git: boolean;
+    };
+
+    if (options.yes) {
+      answers = {
+        projectName: projectName || 'my-app',
+        template: options.template || templates[0].name,
+        packageManager: options.pm || 'pnpm',
+        install: options.install !== false,
+        git: options.git !== false,
+      };
+    } else {
+      const prompted = await inquirer.prompt([
+        {
+          type: 'input',
+          name: 'projectName',
+          message: 'Project name:',
+          default: projectName || 'my-app',
+          when: !projectName,
+          validate: (input: string) => {
+            const validation = validateNpmPackageName(input);
+            if (!validation.validForNewPackages) {
+              return validation.errors?.[0] || 'Invalid package name';
+            }
+            return true;
+          },
+        },
+        {
+          type: 'list',
+          name: 'template',
+          message: 'Select a template:',
+          choices: templates.map((t) => ({
+            name: `${t.displayName} - ${t.description}`,
+            value: t.name,
+          })),
+          when: !options.template,
+        },
+        {
+          type: 'list',
+          name: 'packageManager',
+          message: 'Select a package manager:',
+          choices: ['pnpm', 'npm', 'yarn'],
+          default: 'pnpm',
+          when: !options.pm,
+        },
+        {
+          type: 'confirm',
+          name: 'install',
+          message: 'Install dependencies?',
+          default: true,
+          when: options.install !== false,
+        },
+        {
+          type: 'confirm',
+          name: 'git',
+          message: 'Initialize git repository?',
+          default: true,
+          when: options.git !== false,
+        },
+      ]);
+
+      answers = {
+        projectName: projectName || prompted.projectName,
+        template: options.template || prompted.template,
+        packageManager: options.pm || prompted.packageManager,
+        install: options.install !== false && (prompted.install ?? true),
+        git: options.git !== false && (prompted.git ?? true),
+      };
+    }
+
+    const targetDir = path.join(process.cwd(), answers.projectName);
+
+    // Check if directory exists
+    if (await fs.pathExists(targetDir)) {
+      logger.error(`Directory "${answers.projectName}" already exists`);
+      logger.info('Please choose a different name or remove the existing directory.');
+      process.exit(1);
+    }
+
+    // Validate template exists
+    const selectedTemplate = templates.find((t) => t.name === answers.template);
+    if (!selectedTemplate) {
+      logger.error(`Template "${answers.template}" not found`);
+      process.exit(1);
+    }
+
+    logger.newLine();
+
+    // Copy template
+    const templatePath = path.join(templatesDir, answers.template);
+    await copyTemplate(templatePath, targetDir, answers.projectName);
+
+    // Install dependencies
+    if (answers.install) {
+      await installDependencies(targetDir, answers.packageManager);
+    }
+
+    // Initialize git
+    if (answers.git) {
+      await initGit(targetDir);
+    }
+
+    logger.newLine();
+    logger.success(`Created ${chalk.bold(answers.projectName)}`);
+    logger.newLine();
+    logger.log(`Next steps:`);
+    logger.log(`  ${chalk.cyan('cd')} ${answers.projectName}`);
+    if (!answers.install) {
+      logger.log(`  ${chalk.cyan(answers.packageManager)} install`);
+    }
+    logger.log(
+      `  ${chalk.cyan(answers.packageManager)} ${answers.packageManager === 'npm' ? 'run ' : ''}dev`
+    );
+    logger.newLine();
+  } catch (error) {
+    logger.error(`Failed to create project: ${(error as Error).message}`);
+    process.exit(1);
+  }
+}
+
+async function getAvailableTemplates(templatesDir: string): Promise<TemplateMetadata[]> {
+  if (!(await fs.pathExists(templatesDir))) {
+    return [];
+  }
+
+  const templateDirs = await fs.readdir(templatesDir);
+  const templates: TemplateMetadata[] = [];
+
+  for (const dir of templateDirs) {
+    const metadataPath = path.join(templatesDir, dir, 'template.json');
+    if (await fs.pathExists(metadataPath)) {
+      const metadata = await fs.readJSON(metadataPath);
+      templates.push(metadata);
+    }
+  }
+
+  return templates;
+}