create-blitzpack 0.1.10 → 0.1.12

package/dist/index.js

@@ -155,6 +155,65 @@ var REPLACEABLE_FILES = [
   "README.md"
 ];
 var DEFAULT_DESCRIPTION = "A full-stack TypeScript monorepo built with Blitzpack";
+var OPTIONAL_FEATURES = [
+  {
+    key: "testing",
+    name: "Testing",
+    description: "vitest, integration tests, test helpers"
+  },
+  {
+    key: "admin",
+    name: "Admin Dashboard",
+    description: "user management, stats, sessions admin"
+  },
+  {
+    key: "uploads",
+    name: "File Uploads",
+    description: "S3 storage, upload routes, file components"
+  }
+];
+var FEATURE_EXCLUSIONS = {
+  testing: [
+    "vitest.workspace.ts",
+    "vitest.shared.ts",
+    "apps/api/test",
+    "apps/api/vitest.config.ts",
+    "apps/web/src/test",
+    "apps/web/vitest.config.ts",
+    "packages/types/src/__tests__",
+    "packages/types/vitest.config.ts",
+    "packages/utils/src/__tests__",
+    "packages/utils/vitest.config.ts",
+    "packages/ui/src/__tests__",
+    "packages/ui/vitest.config.ts",
+    "packages/ui/vitest.setup.ts",
+    "packages/ui/test-config.js",
+    "apps/web/src/hooks/api/__tests__"
+  ],
+  admin: [
+    "apps/web/src/app/(admin)",
+    "apps/web/src/components/admin",
+    "apps/web/src/hooks/api/use-admin-sessions.ts",
+    "apps/web/src/hooks/api/use-admin-stats.ts",
+    "apps/web/src/hooks/use-realtime-metrics.ts",
+    "apps/api/src/routes/admin-sessions.ts",
+    "apps/api/src/routes/stats.ts",
+    "apps/api/src/routes/metrics.ts",
+    "apps/api/src/services/stats.service.ts",
+    "apps/api/src/services/metrics.service.ts",
+    "packages/types/src/stats.ts"
+  ],
+  uploads: [
+    "apps/api/src/routes/uploads.ts",
+    "apps/api/src/routes/uploads-serve.ts",
+    "apps/api/src/services/uploads.service.ts",
+    "apps/api/src/services/file-storage.service.ts",
+    "apps/api/public/uploads",
+    "apps/web/src/hooks/api/use-uploads.ts",
+    "packages/ui/src/file-upload-input.tsx",
+    "packages/types/src/upload.ts"
+  ]
+};
 
 // src/utils.ts
 import chalk2 from "chalk";
@@ -310,6 +369,10 @@ async function getProjectOptions(providedName, flags = {}) {
     console.log(`Invalid project name: ${validation.problems?.[0]}`);
     return null;
   }
+  const features = await promptFeatureSelection();
+  if (!features) {
+    return null;
+  }
   const useCurrentDir = projectName === ".";
   const actualProjectName = useCurrentDir ? getCurrentDirName() : projectName;
   return {
@@ -318,7 +381,40 @@ async function getProjectOptions(providedName, flags = {}) {
     projectDescription: response.projectDescription || DEFAULT_DESCRIPTION,
     skipGit: flags.skipGit || false,
     skipInstall: flags.skipInstall || false,
-    useCurrentDir
+    useCurrentDir,
+    features
+  };
+}
+async function promptFeatureSelection() {
+  const featureChoices = OPTIONAL_FEATURES.map((feature) => ({
+    title: `${feature.name} ${chalk3.dim(`(${feature.description})`)}`,
+    value: feature.key,
+    selected: true
+  }));
+  let cancelled = false;
+  const { selectedFeatures } = await prompts(
+    {
+      type: "multiselect",
+      name: "selectedFeatures",
+      message: "Include optional features:",
+      choices: featureChoices,
+      hint: "- Space to toggle, Enter to confirm",
+      instructions: false
+    },
+    {
+      onCancel: () => {
+        cancelled = true;
+      }
+    }
+  );
+  if (cancelled) {
+    return null;
+  }
+  const selected = selectedFeatures || [];
+  return {
+    testing: selected.includes("testing"),
+    admin: selected.includes("admin"),
+    uploads: selected.includes("uploads")
   };
 }
 async function promptAutomaticSetup() {
@@ -357,15 +453,25 @@ var POST_DOWNLOAD_EXCLUDES = [
   "Dockerfile",
   "docker-compose.prod.yml"
 ];
-async function cleanupExcludes(targetDir) {
-  for (const exclude of POST_DOWNLOAD_EXCLUDES) {
+function getFeatureExclusions(features) {
+  const exclusions = [];
+  for (const [key, enabled] of Object.entries(features)) {
+    if (!enabled) {
+      exclusions.push(...FEATURE_EXCLUSIONS[key]);
+    }
+  }
+  return exclusions;
+}
+async function cleanupExcludes(targetDir, additionalExcludes = []) {
+  const allExcludes = [...POST_DOWNLOAD_EXCLUDES, ...additionalExcludes];
+  for (const exclude of allExcludes) {
     const fullPath = path2.join(targetDir, exclude);
     if (await fs.pathExists(fullPath)) {
       await fs.remove(fullPath);
     }
   }
 }
-async function downloadAndPrepareTemplate(targetDir, spinner) {
+async function downloadAndPrepareTemplate(targetDir, spinner, features) {
   spinner.text = "Fetching template from GitHub...";
   await downloadTemplate(GITHUB_REPO, {
     dir: targetDir,
@@ -374,7 +480,8 @@ async function downloadAndPrepareTemplate(targetDir, spinner) {
   spinner.text = "Extracting files...";
   await new Promise((resolve) => setTimeout(resolve, 100));
   spinner.text = "Cleaning up template files...";
-  await cleanupExcludes(targetDir);
+  const featureExclusions = getFeatureExclusions(features);
+  await cleanupExcludes(targetDir, featureExclusions);
   const files = await countFiles(targetDir);
   spinner.succeed(`Downloaded template (${files} files)`);
 }
@@ -400,7 +507,62 @@ async function countFiles(dir) {
 // src/transform.ts
 import fs2 from "fs-extra";
 import path3 from "path";
-function transformPackageJson(content, vars, filePath) {
+var TESTING_SCRIPTS = [
+  "test",
+  "test:unit",
+  "test:integration",
+  "test:watch",
+  "test:coverage",
+  "test:parallel"
+];
+var TESTING_ROOT_DEVDEPS = [
+  "@testing-library/jest-dom",
+  "@testing-library/react",
+  "@testing-library/user-event",
+  "@vitest/coverage-v8",
+  "jsdom",
+  "vitest"
+];
+var TESTING_APP_DEVDEPS = ["vitest", "vite-tsconfig-paths"];
+var UPLOADS_API_DEPS = ["@aws-sdk/client-s3", "sharp"];
+var MARKER_FILES = [
+  "apps/api/src/app.ts",
+  "apps/api/src/plugins/services.ts",
+  "apps/api/prisma/schema.prisma"
+];
+function stripFeatureBlocks(content, disabledFeatures) {
+  const lines = content.split("\n");
+  const result = [];
+  let skipUntilEnd = false;
+  let currentFeature = null;
+  for (const line of lines) {
+    const featureStart = line.match(/\/\/\s*@feature\s+(\w+)/);
+    const featureEnd = line.match(/\/\/\s*@endfeature/);
+    if (featureStart) {
+      const feature = featureStart[1];
+      if (disabledFeatures.includes(feature)) {
+        skipUntilEnd = true;
+        currentFeature = feature;
+      }
+      continue;
+    }
+    if (featureEnd) {
+      if (skipUntilEnd) {
+        skipUntilEnd = false;
+        currentFeature = null;
+      }
+      continue;
+    }
+    if (!skipUntilEnd) {
+      result.push(line);
+    }
+  }
+  return result.join("\n");
+}
+function cleanEmptyLines(content) {
+  return content.replace(/\n{3,}/g, "\n\n");
+}
+function transformPackageJson(content, vars, filePath, features) {
   const pkg = JSON.parse(content);
   if (filePath === "package.json") {
     pkg.name = vars.projectSlug;
@@ -409,6 +571,31 @@ function transformPackageJson(content, vars, filePath) {
     delete pkg.homepage;
     delete pkg.scripts?.["init:project"];
     pkg.version = "0.1.0";
+    if (!features.testing) {
+      for (const script of TESTING_SCRIPTS) {
+        delete pkg.scripts?.[script];
+      }
+      for (const dep of TESTING_ROOT_DEVDEPS) {
+        delete pkg.devDependencies?.[dep];
+      }
+    }
+  }
+  if (filePath === "apps/api/package.json" || filePath === "apps/web/package.json") {
+    if (!features.testing) {
+      for (const script of TESTING_SCRIPTS) {
+        delete pkg.scripts?.[script];
+      }
+      for (const dep of TESTING_APP_DEVDEPS) {
+        delete pkg.devDependencies?.[dep];
+      }
+    }
+  }
+  if (filePath === "apps/api/package.json") {
+    if (!features.uploads) {
+      for (const dep of UPLOADS_API_DEPS) {
+        delete pkg.dependencies?.[dep];
+      }
+    }
   }
   return JSON.stringify(pkg, null, 2) + "\n";
 }
@@ -475,8 +662,13 @@ pnpm db:seed          # Seed database
 Built with [Blitzpack](https://github.com/CarboxyDev/blitzpack)
 `;
 }
-async function transformFiles(targetDir, vars) {
-  for (const relativePath of REPLACEABLE_FILES) {
+async function transformFiles(targetDir, vars, features) {
+  const filesToTransform = [
+    ...REPLACEABLE_FILES,
+    "apps/api/package.json",
+    "apps/web/package.json"
+  ];
+  for (const relativePath of filesToTransform) {
     const filePath = path3.join(targetDir, relativePath);
     if (!await fs2.pathExists(filePath)) {
       continue;
@@ -486,7 +678,7 @@ async function transformFiles(targetDir, vars) {
     if (relativePath === "README.md") {
       transformed = generateReadme(vars);
     } else if (relativePath.endsWith("package.json")) {
-      transformed = transformPackageJson(content, vars, relativePath);
+      transformed = transformPackageJson(content, vars, relativePath, features);
     } else if (relativePath.includes("site.ts")) {
       transformed = transformSiteConfig(content, vars);
     } else if (relativePath.includes("layout.tsx")) {
@@ -498,6 +690,42 @@ async function transformFiles(targetDir, vars) {
     }
     await fs2.writeFile(filePath, transformed, "utf-8");
   }
+  await applyFeatureTransforms(targetDir, features);
+}
+async function applyFeatureTransforms(targetDir, features) {
+  const disabledFeatures = [];
+  if (!features.testing) disabledFeatures.push("testing");
+  if (!features.admin) disabledFeatures.push("admin");
+  if (!features.uploads) disabledFeatures.push("uploads");
+  for (const relativePath of MARKER_FILES) {
+    const filePath = path3.join(targetDir, relativePath);
+    if (await fs2.pathExists(filePath)) {
+      let content = await fs2.readFile(filePath, "utf-8");
+      content = stripFeatureBlocks(content, disabledFeatures);
+      content = cleanEmptyLines(content);
+      await fs2.writeFile(filePath, content);
+    }
+  }
+  if (!features.testing) {
+    await transformForNoTesting(targetDir);
+  }
+}
+async function transformForNoTesting(targetDir) {
+  const turboPath = path3.join(targetDir, "turbo.json");
+  if (await fs2.pathExists(turboPath)) {
+    const content = await fs2.readFile(turboPath, "utf-8");
+    const turbo = JSON.parse(content);
+    delete turbo.tasks?.test;
+    delete turbo.tasks?.["test:unit"];
+    delete turbo.tasks?.["test:integration"];
+    delete turbo.tasks?.["test:watch"];
+    delete turbo.tasks?.["test:coverage"];
+    await fs2.writeFile(turboPath, JSON.stringify(turbo, null, 2) + "\n");
+  }
+  const huskyPath = path3.join(targetDir, ".husky/pre-push");
+  if (await fs2.pathExists(huskyPath)) {
+    await fs2.writeFile(huskyPath, "pnpm typecheck\n");
+  }
 }
 
 // src/commands/create.ts
@@ -537,6 +765,19 @@ function printDryRun(options) {
     `    ${chalk4.cyan("Description:")}  ${options.projectDescription}`
   );
   console.log();
+  console.log(chalk4.bold("  Features:"));
+  console.log();
+  const featureStatus = (enabled) => enabled ? chalk4.green("\u2713") : chalk4.red("\u2717");
+  console.log(
+    `    ${featureStatus(options.features.testing)} Testing ${chalk4.dim("(vitest, integration tests)")}`
+  );
+  console.log(
+    `    ${featureStatus(options.features.admin)} Admin Dashboard ${chalk4.dim("(user management, stats)")}`
+  );
+  console.log(
+    `    ${featureStatus(options.features.uploads)} File Uploads ${chalk4.dim("(S3 storage, upload routes)")}`
+  );
+  console.log();
   console.log(chalk4.bold("  Would run:"));
   console.log();
   console.log(`    ${chalk4.dim("\u2022")} Download template from GitHub`);
@@ -568,7 +809,8 @@ async function create(projectName, flags) {
       projectDescription: options.projectDescription,
       targetDir,
       skipGit: options.skipGit,
-      skipInstall: options.skipInstall
+      skipInstall: options.skipInstall,
+      features: options.features
     });
     return;
   }
@@ -594,13 +836,17 @@ async function create(projectName, flags) {
   const spinner = ora();
   try {
     spinner.start("Downloading template from GitHub...");
-    await downloadAndPrepareTemplate(targetDir, spinner);
+    await downloadAndPrepareTemplate(targetDir, spinner, options.features);
     spinner.start("Configuring project...");
-    await transformFiles(targetDir, {
-      projectName: options.projectName,
-      projectSlug: options.projectSlug,
-      projectDescription: options.projectDescription
-    });
+    await transformFiles(
+      targetDir,
+      {
+        projectName: options.projectName,
+        projectSlug: options.projectSlug,
+        projectDescription: options.projectDescription
+      },
+      options.features
+    );
     await copyEnvFiles(targetDir);
     spinner.succeed("Configured project");
     if (!options.skipGit && isGitInstalled()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-blitzpack",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Create a new Blitzpack project - full-stack TypeScript monorepo with Next.js and Fastify",
   "type": "module",
   "bin": {
@@ -16,21 +16,21 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "chalk": "^5.4.1",
+    "chalk": "^5.6.2",
     "commander": "^13.1.0",
-    "fs-extra": "^11.3.0",
+    "fs-extra": "^11.3.3",
     "giget": "^2.0.0",
     "ora": "^8.2.0",
     "prompts": "^2.4.2",
-    "validate-npm-package-name": "^6.0.0"
+    "validate-npm-package-name": "^6.0.2"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22.10.5",
+    "@types/node": "^22.19.3",
     "@types/prompts": "^2.4.9",
     "@types/validate-npm-package-name": "^4.0.2",
-    "tsup": "^8.5.0",
-    "typescript": "^5.7.2"
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
   },
   "keywords": [
     "create",