create-blitzpack 0.1.5 → 0.1.6

package/dist/index.js

@@ -7,18 +7,122 @@ import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 
 // src/commands/create.ts
-import chalk2 from "chalk";
+import chalk4 from "chalk";
 import { spawn } from "child_process";
 import fs3 from "fs-extra";
 import ora from "ora";
 import path4 from "path";
 import prompts2 from "prompts";
 
-// src/git.ts
+// src/checks.ts
+import chalk from "chalk";
 import { execSync } from "child_process";
+function checkNodeVersion() {
+  try {
+    const nodeVersion = process.version;
+    const majorVersion = parseInt(nodeVersion.slice(1).split(".")[0], 10);
+    if (majorVersion >= 20) {
+      return {
+        passed: true,
+        name: "Node.js"
+      };
+    }
+    return {
+      passed: false,
+      name: "Node.js",
+      message: `Node.js >= 20.0.0 required (found ${nodeVersion})`
+    };
+  } catch {
+    return {
+      passed: false,
+      name: "Node.js",
+      message: "Failed to check Node.js version"
+    };
+  }
+}
+function checkPnpmInstalled() {
+  try {
+    execSync("pnpm --version", { stdio: "ignore" });
+    return {
+      passed: true,
+      name: "pnpm"
+    };
+  } catch {
+    return {
+      passed: false,
+      name: "pnpm",
+      message: "pnpm not found. Install: npm install -g pnpm"
+    };
+  }
+}
+async function runPreflightChecks() {
+  console.log();
+  console.log(chalk.bold("  Checking requirements..."));
+  console.log();
+  const checks = [checkNodeVersion(), checkPnpmInstalled()];
+  let hasErrors = false;
+  for (const check of checks) {
+    if (check.passed) {
+      console.log(chalk.green("  \u2714"), check.name);
+    } else {
+      hasErrors = true;
+      console.log(chalk.red("  \u2716"), check.name);
+      if (check.message) {
+        console.log(chalk.dim(`    ${check.message}`));
+      }
+    }
+  }
+  console.log();
+  if (hasErrors) {
+    console.log(
+      chalk.red("  \u2716"),
+      "Requirements not met. Please fix the errors above."
+    );
+    console.log();
+    return false;
+  }
+  return true;
+}
+
+// src/docker.ts
+import { execSync as execSync2 } from "child_process";
+function isDockerRunning() {
+  try {
+    execSync2("docker info", { stdio: "ignore", timeout: 3e3 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function runDockerCompose(targetDir) {
+  try {
+    execSync2("docker compose up -d", {
+      cwd: targetDir,
+      stdio: "inherit"
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function runDatabaseMigrations(targetDir) {
+  try {
+    const isWindows = process.platform === "win32";
+    execSync2(isWindows ? "pnpm.cmd db:migrate" : "pnpm db:migrate", {
+      cwd: targetDir,
+      stdio: "inherit"
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/git.ts
+import { execSync as execSync3 } from "child_process";
 function isGitInstalled() {
   try {
-    execSync("git --version", { stdio: "ignore" });
+    execSync3("git --version", { stdio: "ignore" });
     return true;
   } catch {
     return false;
@@ -26,9 +130,9 @@ function isGitInstalled() {
 }
 function initGit(targetDir) {
   try {
-    execSync("git init", { cwd: targetDir, stdio: "ignore" });
-    execSync("git add -A", { cwd: targetDir, stdio: "ignore" });
-    execSync('git commit -m "Initial commit from create-blitzpack"', {
+    execSync3("git init", { cwd: targetDir, stdio: "ignore" });
+    execSync3("git add -A", { cwd: targetDir, stdio: "ignore" });
+    execSync3('git commit -m "Initial commit from create-blitzpack"', {
       cwd: targetDir,
       stdio: "ignore"
     });
@@ -39,6 +143,7 @@ function initGit(targetDir) {
 }
 
 // src/prompts.ts
+import chalk3 from "chalk";
 import prompts from "prompts";
 
 // src/constants.ts
@@ -52,7 +157,7 @@ var REPLACEABLE_FILES = [
 var DEFAULT_DESCRIPTION = "A full-stack TypeScript monorepo built with Blitzpack";
 
 // src/utils.ts
-import chalk from "chalk";
+import chalk2 from "chalk";
 import path from "path";
 import validatePackageName from "validate-npm-package-name";
 function getCurrentDirName() {
@@ -74,51 +179,95 @@ function validateProjectName(name) {
 }
 function printHeader() {
   console.log();
-  console.log(chalk.bold.cyan("  Create Blitzpack"));
-  console.log(chalk.dim("  Full-stack TypeScript monorepo"));
+  console.log(chalk2.bold.cyan("  Create Blitzpack"));
+  console.log(chalk2.dim("  Full-stack TypeScript monorepo"));
   console.log();
 }
-function printSuccess(projectName, targetDir) {
-  console.log();
-  console.log(chalk.green("\u2714"), chalk.bold(`Created ${projectName}`));
+function printSuccess(projectName, targetDir, ranAutomaticSetup = false) {
   console.log();
-  console.log(chalk.bold("  Next steps:"));
+  console.log(chalk2.green("\u2714"), chalk2.bold(`Created ${projectName}`));
   console.log();
-  let stepNumber = 1;
-  if (targetDir !== ".") {
-    console.log(chalk.cyan(`  ${stepNumber}.`), `cd ${targetDir}`);
+  if (ranAutomaticSetup) {
+    console.log(
+      chalk2.green("\u2714"),
+      chalk2.dim("Database setup complete! Ready to start developing.")
+    );
+    console.log();
+    console.log(chalk2.bold("  Next steps:"));
+    console.log();
+    let stepNumber = 1;
+    if (targetDir !== ".") {
+      console.log(
+        chalk2.cyan(`  ${stepNumber}.`),
+        chalk2.bold(`cd ${targetDir}`)
+      );
+      stepNumber++;
+    }
+    console.log(chalk2.cyan(`  ${stepNumber}.`), chalk2.bold("pnpm dev"));
+    console.log(chalk2.dim("      Start development servers (web + api)"));
+    console.log();
+    console.log(chalk2.dim("  Optional commands:"));
+    console.log(
+      chalk2.dim(
+        "    \u2022 pnpm db:seed       Add test data (admin accounts, users)"
+      )
+    );
+    console.log(
+      chalk2.dim("    \u2022 pnpm db:studio     Open Prisma Studio to view data")
+    );
+  } else {
+    console.log(
+      chalk2.dim("  Setup complete! Follow these steps to start developing:")
+    );
+    console.log();
+    let stepNumber = 1;
+    if (targetDir !== ".") {
+      console.log(
+        chalk2.cyan(`  ${stepNumber}.`),
+        chalk2.bold(`cd ${targetDir}`)
+      );
+      stepNumber++;
+    }
+    console.log(
+      chalk2.cyan(`  ${stepNumber}.`),
+      chalk2.bold("docker compose up -d")
+    );
+    console.log(chalk2.dim("      Start PostgreSQL database (requires Docker)"));
+    console.log();
+    stepNumber++;
+    console.log(chalk2.cyan(`  ${stepNumber}.`), chalk2.bold("pnpm db:migrate"));
+    console.log(chalk2.dim("      Run database migrations and setup schema"));
+    console.log();
     stepNumber++;
+    console.log(chalk2.cyan(`  ${stepNumber}.`), chalk2.bold("pnpm dev"));
+    console.log(chalk2.dim("      Start development servers (web + api)"));
+    console.log();
+    console.log(chalk2.dim("  Optional commands:"));
+    console.log(
+      chalk2.dim(
+        "    \u2022 pnpm db:seed       Add test data (admin accounts, users)"
+      )
+    );
+    console.log(
+      chalk2.dim("    \u2022 pnpm db:studio     Open Prisma Studio to view data")
+    );
   }
+  console.log();
+  console.log(chalk2.bold("  Your app will be running at:"));
   console.log(
-    chalk.cyan(`  ${stepNumber}.`),
-    "docker compose up -d",
-    chalk.dim("  # Start PostgreSQL")
-  );
-  stepNumber++;
-  console.log(
-    chalk.cyan(`  ${stepNumber}.`),
-    "pnpm db:migrate",
-    chalk.dim("       # Run database migrations")
+    chalk2.dim("    \u2022 Web:      ") + chalk2.cyan("http://localhost:3000")
   );
-  stepNumber++;
   console.log(
-    chalk.cyan(`  ${stepNumber}.`),
-    "pnpm dev",
-    chalk.dim("              # Start dev servers")
+    chalk2.dim("    \u2022 API:      ") + chalk2.cyan("http://localhost:8080/api")
   );
-  console.log();
-  console.log(
-    chalk.dim("  Optional: pnpm db:seed to add test data like admin accounts")
-  );
-  console.log();
   console.log(
-    chalk.dim("  Web: http://localhost:3000 | API: http://localhost:8080")
+    chalk2.dim("    \u2022 API Docs: ") + chalk2.cyan("http://localhost:8080/docs")
   );
   console.log();
 }
 function printError(message) {
   console.log();
-  console.log(chalk.red("\u2716"), message);
+  console.log(chalk2.red("\u2716"), message);
   console.log();
 }
 
@@ -172,6 +321,29 @@ async function getProjectOptions(providedName, flags = {}) {
     useCurrentDir
   };
 }
+async function promptAutomaticSetup() {
+  const dockerRunning = isDockerRunning();
+  if (!dockerRunning) {
+    console.log();
+    console.log(
+      chalk3.yellow("  \u26A0"),
+      "Docker is not running. Skipping automatic setup."
+    );
+    console.log(
+      chalk3.dim("    Start Docker and run setup steps manually (see below).")
+    );
+    console.log();
+    return false;
+  }
+  console.log();
+  const { runSetup } = await prompts({
+    type: "confirm",
+    name: "runSetup",
+    message: "Run initial setup now? (docker compose + database migrations)",
+    initial: true
+  });
+  return runSetup || false;
+}
 
 // src/template.ts
 import fs from "fs-extra";
@@ -192,12 +364,36 @@ async function cleanupExcludes(targetDir) {
     }
   }
 }
-async function downloadAndPrepareTemplate(targetDir) {
+async function downloadAndPrepareTemplate(targetDir, spinner) {
+  spinner.text = "Fetching template from GitHub...";
   await downloadTemplate(GITHUB_REPO, {
     dir: targetDir,
     force: true
   });
+  spinner.text = "Extracting files...";
+  await new Promise((resolve) => setTimeout(resolve, 100));
+  spinner.text = "Cleaning up template files...";
   await cleanupExcludes(targetDir);
+  const files = await countFiles(targetDir);
+  spinner.succeed(`Downloaded template (${files} files)`);
+}
+async function countFiles(dir) {
+  try {
+    let count = 0;
+    const items = await fs.readdir(dir);
+    for (const item of items) {
+      const fullPath = path2.join(dir, item);
+      const stat = await fs.stat(fullPath);
+      if (stat.isDirectory()) {
+        count += await countFiles(fullPath);
+      } else {
+        count++;
+      }
+    }
+    return count;
+  } catch {
+    return 0;
+  }
 }
 
 // src/transform.ts
@@ -329,32 +525,36 @@ function runInstall(cwd) {
   });
 }
 function printDryRun(options) {
-  console.log(chalk2.yellow("  Dry run mode - no changes will be made"));
+  console.log(chalk4.yellow("  Dry run mode - no changes will be made"));
   console.log();
-  console.log(chalk2.bold("  Would create:"));
+  console.log(chalk4.bold("  Would create:"));
   console.log();
-  console.log(`    ${chalk2.cyan("Directory:")}    ${options.targetDir}`);
-  console.log(`    ${chalk2.cyan("Name:")}         ${options.projectName}`);
-  console.log(`    ${chalk2.cyan("Slug:")}         ${options.projectSlug}`);
+  console.log(`    ${chalk4.cyan("Directory:")}    ${options.targetDir}`);
+  console.log(`    ${chalk4.cyan("Name:")}         ${options.projectName}`);
+  console.log(`    ${chalk4.cyan("Slug:")}         ${options.projectSlug}`);
   console.log(
-    `    ${chalk2.cyan("Description:")}  ${options.projectDescription}`
+    `    ${chalk4.cyan("Description:")}  ${options.projectDescription}`
   );
   console.log();
-  console.log(chalk2.bold("  Would run:"));
+  console.log(chalk4.bold("  Would run:"));
   console.log();
-  console.log(`    ${chalk2.dim("\u2022")} Download template from GitHub`);
-  console.log(`    ${chalk2.dim("\u2022")} Transform package.json files`);
-  console.log(`    ${chalk2.dim("\u2022")} Create .env.local files`);
+  console.log(`    ${chalk4.dim("\u2022")} Download template from GitHub`);
+  console.log(`    ${chalk4.dim("\u2022")} Transform package.json files`);
+  console.log(`    ${chalk4.dim("\u2022")} Create .env.local files`);
   if (!options.skipGit) {
-    console.log(`    ${chalk2.dim("\u2022")} Initialize git repository`);
+    console.log(`    ${chalk4.dim("\u2022")} Initialize git repository`);
   }
   if (!options.skipInstall) {
-    console.log(`    ${chalk2.dim("\u2022")} Install dependencies (pnpm install)`);
+    console.log(`    ${chalk4.dim("\u2022")} Install dependencies (pnpm install)`);
   }
   console.log();
 }
 async function create(projectName, flags) {
   printHeader();
+  const checksPass = await runPreflightChecks();
+  if (!checksPass) {
+    process.exit(1);
+  }
   const options = await getProjectOptions(projectName, flags);
   if (!options) {
     return;
@@ -393,8 +593,7 @@ async function create(projectName, flags) {
   const spinner = ora();
   try {
     spinner.start("Downloading template from GitHub...");
-    await downloadAndPrepareTemplate(targetDir);
-    spinner.succeed("Downloaded template");
+    await downloadAndPrepareTemplate(targetDir, spinner);
     spinner.start("Configuring project...");
     await transformFiles(targetDir, {
       projectName: options.projectName,
@@ -423,9 +622,34 @@ async function create(projectName, flags) {
         );
       }
     }
+    let ranAutomaticSetup = false;
+    const shouldRunSetup = await promptAutomaticSetup();
+    if (shouldRunSetup) {
+      console.log();
+      spinner.start("Starting PostgreSQL database...");
+      const dockerSuccess = runDockerCompose(targetDir);
+      if (dockerSuccess) {
+        spinner.succeed("Started PostgreSQL database");
+        spinner.start("Running database migrations...");
+        const migrationsSuccess = runDatabaseMigrations(targetDir);
+        if (migrationsSuccess) {
+          spinner.succeed("Database migrations complete");
+          ranAutomaticSetup = true;
+        } else {
+          spinner.warn(
+            'Failed to run migrations. Run "pnpm db:migrate" manually.'
+          );
+        }
+      } else {
+        spinner.warn(
+          'Failed to start Docker. Run "docker compose up -d" manually.'
+        );
+      }
+    }
     printSuccess(
       options.projectName,
-      options.useCurrentDir ? "." : options.projectName
+      options.useCurrentDir ? "." : options.projectName,
+      ranAutomaticSetup
     );
   } catch (error) {
     spinner.fail();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-blitzpack",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Create a new Blitzpack project - full-stack TypeScript monorepo with Next.js and Fastify",
   "type": "module",
   "bin": {