initkit 1.1.0 → 1.2.1

package/src/utils/frameworkBootstrap.js

@@ -0,0 +1,304 @@
+import path from 'path';
+import { execCommand } from './cliRunner.js';
+import chalk from 'chalk';
+
+/**
+ * Bootstrap a project using official framework CLIs
+ *
+ * This function delegates project creation to official framework CLIs
+ * instead of manually creating files. This ensures we always use the
+ * latest best practices and configurations from framework maintainers.
+ *
+ * @param {string} projectPath - Absolute path to the project directory
+ * @param {Object} config - User configuration object
+ * @returns {Promise<void>}
+ */
+export async function bootstrapWithOfficialCLI(projectPath, config) {
+  const { projectType, frontend, backend } = config;
+
+  switch (projectType) {
+    case 'frontend':
+      return bootstrapFrontend(projectPath, config);
+
+    case 'backend':
+      return bootstrapBackend(projectPath, config);
+
+    default:
+      throw new Error(`Unsupported project type: ${projectType}`);
+  }
+}
+
+/**
+ * Bootstrap a frontend project
+ */
+async function bootstrapFrontend(projectPath, config) {
+  const { frontend } = config;
+
+  switch (frontend) {
+    case 'nextjs':
+      return bootstrapNextjs(projectPath, config);
+
+    case 'react':
+      return bootstrapReact(projectPath, config);
+
+    case 'vue':
+      return bootstrapVue(projectPath, config);
+
+    case 'nuxt':
+      return bootstrapNuxt(projectPath, config);
+
+    case 'svelte':
+      return bootstrapSvelte(projectPath, config);
+
+    default:
+      throw new Error(`Unsupported frontend framework: ${frontend}`);
+  }
+}
+
+/**
+ * Bootstrap a backend project
+ */
+async function bootstrapBackend(projectPath, config) {
+  const { backend } = config;
+
+  switch (backend) {
+    case 'express':
+      return bootstrapExpress(projectPath, config);
+
+    case 'nestjs':
+      return bootstrapNestJS(projectPath, config);
+
+    case 'fastify':
+      return bootstrapFastify(projectPath, config);
+
+    default:
+      throw new Error(`Unsupported backend framework: ${backend}`);
+  }
+}
+
+// ============================================
+// Frontend Framework Bootstrappers
+// ============================================
+
+/**
+ * Bootstrap Next.js project using create-next-app
+ *
+ * @param {string} projectPath - Absolute path to project
+ * @param {Object} config - Configuration object
+ */
+export async function bootstrapNextjs(projectPath, config) {
+  const { language, styling, packageManager = 'npm' } = config;
+  const projectName = path.basename(projectPath);
+  const parentDir = path.dirname(projectPath);
+
+  console.log(chalk.cyan(`\n📦 Creating Next.js project...`));
+  console.log(
+    chalk.gray(`   Language: ${language === 'typescript' ? 'TypeScript' : 'JavaScript'}`)
+  );
+  console.log(chalk.gray(`   Styling: ${styling || 'CSS'}`));
+  console.log(chalk.gray(`   Package Manager: ${packageManager}\n`));
+
+  const args = ['create-next-app@latest', projectName];
+
+  // Language
+  if (language === 'typescript') {
+    args.push('--typescript');
+  } else {
+    args.push('--javascript');
+  }
+
+  // Styling - check if user wants Tailwind
+  if (styling === 'tailwind' || styling === 'tailwindcss') {
+    args.push('--tailwind');
+  } else {
+    args.push('--no-tailwind');
+  }
+
+  // Default options
+  args.push('--eslint'); // Always include ESLint
+  args.push('--app'); // Use App Router
+  args.push('--src-dir'); // Use src directory
+  args.push('--import-alias', '@/*'); // Set import alias
+  args.push('--no-git'); // We handle git separately
+
+  // Package manager
+  args.push(`--use-${packageManager}`);
+
+  // Skip installation - we'll install add-ons after
+  args.push('--skip-install');
+
+  console.log(chalk.dim(`   Command: npx ${args.join(' ')}\n`));
+
+  await execCommand(`npx ${args.join(' ')}`, {
+    cwd: parentDir,
+  });
+}
+
+/**
+ * Bootstrap React project using Vite
+ *
+ * @param {string} projectPath - Absolute path to project
+ * @param {Object} config - Configuration object
+ */
+export async function bootstrapReact(projectPath, config) {
+  const { language = 'typescript', packageManager = 'npm' } = config;
+  const projectName = path.basename(projectPath);
+  const parentDir = path.dirname(projectPath);
+  const template = language === 'typescript' ? 'react-ts' : 'react';
+
+  console.log(chalk.cyan(`\n📦 Creating React project with Vite...`));
+  console.log(
+    chalk.gray(`   Language: ${language === 'typescript' ? 'TypeScript' : 'JavaScript'}`)
+  );
+  console.log(chalk.gray(`   Template: ${template}`));
+  console.log(chalk.gray(`   Package Manager: ${packageManager}\n`));
+
+  // Use create-vite 5.1.0 which is more stable and doesn't auto-start dev server
+  // The --template flag should make it non-interactive
+  const command = `npx create-vite@5.1.0 ${projectName} --template ${template}`;
+  console.log(chalk.dim(`   Command: ${command}\n`));
+
+  await execCommand(command, {
+    cwd: parentDir,
+  });
+}
+
+/**
+ * Bootstrap Vue project
+ *
+ * @param {string} projectPath - Absolute path to project
+ * @param {Object} config - Configuration object
+ */
+export async function bootstrapVue(projectPath, config) {
+  const { language = 'typescript', packageManager = 'npm' } = config;
+  const projectName = path.basename(projectPath);
+  const parentDir = path.dirname(projectPath);
+
+  console.log(chalk.cyan(`\n📦 Creating Vue project...`));
+  console.log(
+    chalk.gray(`   Language: ${language === 'typescript' ? 'TypeScript' : 'JavaScript'}`)
+  );
+  console.log(chalk.gray(`   Package Manager: ${packageManager}\n`));
+
+  // Use --typescript and --default flags to create non-interactive TypeScript project
+  const flags = language === 'typescript' ? '--typescript --default' : '--default';
+  const command = `npm create vue@latest ${projectName} -- ${flags}`;
+  console.log(chalk.dim(`   Command: ${command}\n`));
+
+  await execCommand(command, { cwd: parentDir });
+}
+
+/**
+ * Bootstrap Nuxt project
+ *
+ * @param {string} projectPath - Absolute path to project
+ * @param {Object} config - Configuration object
+ */
+export async function bootstrapNuxt(projectPath, config) {
+  const { packageManager = 'npm' } = config;
+  const projectName = path.basename(projectPath);
+  const parentDir = path.dirname(projectPath);
+
+  console.log(chalk.cyan(`\n📦 Creating Nuxt project...`));
+  console.log(chalk.gray(`   Package Manager: ${packageManager}\n`));
+
+  const command = `npx nuxi@latest init ${projectName} --packageManager ${packageManager}`;
+  console.log(chalk.dim(`   Command: ${command}\n`));
+
+  await execCommand(command, { cwd: parentDir });
+}
+
+/**
+ * Bootstrap Svelte project
+ *
+ * @param {string} projectPath - Absolute path to project
+ * @param {Object} config - Configuration object
+ */
+export async function bootstrapSvelte(projectPath, config) {
+  const { packageManager = 'npm' } = config;
+  const projectName = path.basename(projectPath);
+  const parentDir = path.dirname(projectPath);
+
+  console.log(chalk.cyan(`\n📦 Creating Svelte project...`));
+  console.log(chalk.gray(`   Package Manager: ${packageManager}\n`));
+
+  const command = `npm create svelte@latest ${projectName} -y`;
+  console.log(chalk.dim(`   Command: ${command}\n`));
+
+  await execCommand(command, { cwd: parentDir });
+}
+
+// ============================================
+// Backend Framework Bootstrappers
+// ============================================
+
+/**
+ * Bootstrap Express project
+ *
+ * @param {string} projectPath - Absolute path to project
+ * @param {Object} config - Configuration object
+ */
+export async function bootstrapExpress(projectPath, config) {
+  const { language, packageManager = 'npm' } = config;
+  const projectName = path.basename(projectPath);
+  const parentDir = path.dirname(projectPath);
+
+  console.log(chalk.cyan(`\n📦 Creating Express project...`));
+  console.log(
+    chalk.gray(`   Language: ${language === 'typescript' ? 'TypeScript' : 'JavaScript'}\n`)
+  );
+
+  // Express doesn't have a modern CLI, so we'll use express-generator
+  const command = `npx express-generator --no-view --git ${projectName}`;
+  console.log(chalk.dim(`   Command: ${command}\n`));
+
+  await execCommand(command, { cwd: parentDir });
+
+  // If TypeScript, we'll need to convert it later in the template generator
+  if (language === 'typescript') {
+    console.log(chalk.yellow('   TypeScript setup will be added in the next step...\n'));
+  }
+}
+
+/**
+ * Bootstrap NestJS project
+ *
+ * @param {string} projectPath - Absolute path to project
+ * @param {Object} config - Configuration object
+ */
+export async function bootstrapNestJS(projectPath, config) {
+  const { packageManager = 'npm' } = config;
+  const projectName = path.basename(projectPath);
+  const parentDir = path.dirname(projectPath);
+
+  console.log(chalk.cyan(`\n📦 Creating NestJS project...`));
+  console.log(chalk.gray(`   Language: TypeScript (NestJS default)`));
+  console.log(chalk.gray(`   Package Manager: ${packageManager}\n`));
+
+  const command = `npx @nestjs/cli new ${projectName} --package-manager ${packageManager} --skip-git --skip-install`;
+  console.log(chalk.dim(`   Command: ${command}\n`));
+
+  await execCommand(command, { cwd: parentDir });
+}
+
+/**
+ * Bootstrap Fastify project
+ *
+ * @param {string} projectPath - Absolute path to project
+ * @param {Object} config - Configuration object
+ */
+export async function bootstrapFastify(projectPath, config) {
+  const { language = 'javascript' } = config;
+  const projectName = path.basename(projectPath);
+  const parentDir = path.dirname(projectPath);
+
+  console.log(chalk.cyan(`\n📦 Creating Fastify project...`));
+  console.log(
+    chalk.gray(`   Language: ${language === 'typescript' ? 'TypeScript' : 'JavaScript'}\n`)
+  );
+
+  const command = `npx fastify-cli generate ${projectName}`;
+  console.log(chalk.dim(`   Command: ${command}\n`));
+
+  await execCommand(command, { cwd: parentDir });
+}