Update create-blitzpack, clean scaffold output and stabilize setup flow

Author: CarboxyDev

apps/api/test/helpers/test-db.ts

@@ -1,14 +1,15 @@
-import 'dotenv-flow/config';
-
 import { PrismaPg } from '@prisma/adapter-pg';
 import { execSync } from 'child_process';
+import dotenvFlow from 'dotenv-flow';
 import { Pool } from 'pg';
 
 import { PrismaClient } from '@/generated/client/client.js';
 
 let prisma: PrismaClient | null = null;
 let pool: Pool | null = null;
 
+dotenvFlow.config({ silent: true });
+
 /**
  * Get test database URL
  * Uses DATABASE_URL from env but appends _test suffix to database name

create-blitzpack/package.json

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

create-blitzpack/src/commands/create.ts

@@ -41,6 +41,18 @@ function runInstall(cwd: string): Promise<boolean> {
   });
 }
 
+function installGitHooks(cwd: string): Promise<boolean> {
+  return new Promise((resolve) => {
+    const isWindows = process.platform === 'win32';
+    const child = spawn(isWindows ? 'pnpm.cmd' : 'pnpm', ['exec', 'husky'], {
+      cwd,
+      stdio: 'ignore',
+    });
+    child.on('close', (code) => resolve(code === 0));
+    child.on('error', () => resolve(false));
+  });
+}
+
 interface CreateFlags {
   skipGit?: boolean;
   skipInstall?: boolean;
@@ -128,12 +140,12 @@ function printDryRun(options: {
   console.log(`    ${chalk.dim('•')} Download template from GitHub`);
   console.log(`    ${chalk.dim('•')} Transform package.json files`);
   console.log(`    ${chalk.dim('•')} Create .env.local files`);
-  if (!options.skipGit) {
-    console.log(`    ${chalk.dim('•')} Initialize git repository`);
-  }
   if (!options.skipInstall) {
     console.log(`    ${chalk.dim('•')} Install dependencies (pnpm install)`);
   }
+  if (!options.skipGit) {
+    console.log(`    ${chalk.dim('•')} Initialize git repository`);
+  }
   console.log();
 }
 
@@ -198,6 +210,7 @@ export async function create(
     (shouldRunSetup ? 1 : 0);
   let currentStep = 0;
   let spinner: Ora | undefined;
+  let installSucceeded = false;
 
   try {
     currentStep += 1;
@@ -220,13 +233,39 @@ export async function create(
     await copyEnvFiles(targetDir);
     spinner.succeed('Configured project');
 
+    if (!options.skipInstall) {
+      currentStep += 1;
+      printStepHeader(currentStep, totalSteps, 'Install dependencies');
+      spinner.start('Installing dependencies...');
+      installSucceeded = await runInstall(targetDir);
+      if (installSucceeded) {
+        spinner.succeed('Installed dependencies');
+      } else {
+        spinner.warn(
+          'Failed to install dependencies. Run "pnpm install" manually.'
+        );
+      }
+    }
+
     if (!options.skipGit && isGitInstalled()) {
       currentStep += 1;
       printStepHeader(currentStep, totalSteps, 'Initialize git repository');
       spinner.start('Initializing git repository...');
       const gitSuccess = initGit(targetDir);
       if (gitSuccess) {
-        spinner.succeed('Initialized git repository');
+        if (installSucceeded) {
+          spinner.start('Installing git hooks...');
+          const hooksSuccess = await installGitHooks(targetDir);
+          if (hooksSuccess) {
+            spinner.succeed('Initialized git repository');
+          } else {
+            spinner.warn(
+              'Initialized git repository, but failed to install git hooks'
+            );
+          }
+        } else {
+          spinner.succeed('Initialized git repository');
+        }
       } else {
         spinner.warn('Failed to initialize git repository');
       }
@@ -236,20 +275,6 @@ export async function create(
       spinner.warn('Skipped git initialization (git not installed)');
     }
 
-    if (!options.skipInstall) {
-      currentStep += 1;
-      printStepHeader(currentStep, totalSteps, 'Install dependencies');
-      spinner.start('Installing dependencies...');
-      const success = await runInstall(targetDir);
-      if (success) {
-        spinner.succeed('Installed dependencies');
-      } else {
-        spinner.warn(
-          'Failed to install dependencies. Run "pnpm install" manually.'
-        );
-      }
-    }
-
     let ranAutomaticSetup = false;
 
     if (shouldRunSetup) {

create-blitzpack/src/template.ts

@@ -15,6 +15,8 @@ const POST_DOWNLOAD_EXCLUDES = [
   'create-blitzpack',
   'apps/marketing',
   'CONTRIBUTING.md',
+  'docs/create-blitzpack-scaffolding-maintenance-plan.md',
+  'pnpm-lock.yaml',
 ];
 
 function getFeatureExclusions(features: FeatureOptions): string[] {

create-blitzpack/src/transform.ts

@@ -181,7 +181,8 @@ ${vars.projectDescription}
 
 \`\`\`bash
 pnpm install
-pnpm init:project
+docker compose up -d
+pnpm db:migrate
 pnpm dev
 \`\`\`
 

package.json

@@ -5,7 +5,6 @@
   "type": "module",
   "description": "Production-ready Full Stack TypeScript monorepo with Next.js and Fastify",
   "scripts": {
-    "init:project": "node scripts/setup.js",
     "dev": "turbo run dev",
     "dev:tui": "turbo run dev --ui=tui",
     "dev:debug": "turbo run dev --verbose",