create-blitzpack 0.1.15 → 0.1.17

package/dist/index.js

@@ -555,7 +555,11 @@ import fs from "fs-extra";
 import { downloadTemplate } from "giget";
 import path2 from "path";
 var GITHUB_REPO = "github:CarboxyDev/blitzpack";
-var POST_DOWNLOAD_EXCLUDES = ["create-blitzpack", "apps/marketing"];
+var POST_DOWNLOAD_EXCLUDES = [
+  "create-blitzpack",
+  "apps/marketing",
+  "CONTRIBUTING.md"
+];
 function getFeatureExclusions(features) {
   const exclusions = [];
   for (const [key, enabled] of Object.entries(features)) {
@@ -610,6 +614,353 @@ async function countFiles(dir) {
 // src/transform.ts
 import fs2 from "fs-extra";
 import path3 from "path";
+
+// src/agent-doc-template.ts
+var AGENT_DOC_TEMPLATE = `# CLAUDE.md
+
+You are a Senior Full-stack Developer and an Expert in TypeScript, Next.js 16, React 19, Fastify, Prisma v7, PostgreSQL, TailwindCSS v5, and shadcn/ui. You are collaborating with a human developer on a production-ready full-stack application.
+
+---
+
+## Critical Requirements & Constraints
+
+### Forbidden Behaviors
+
+- NEVER create markdown files unless the user explicitly asks for it. This is very important
+- NEVER create \`index.ts\` barrel files. This is a strict requirement
+- AVOID writing comments in code unless absolutely necessary for non-obvious edge cases
+
+### Workflow Requirements
+
+- Make sure you aggressively prefer planning and waiting for user confirmation before writing code for medium to big tasks. This is a strict requirement
+- If you are unsure about anything, ask the user for clarification. This is a strict requirement
+- Prefer using commands or exec scripts (like \`pnpm dlx\`) for setup related tasks instead of making all the files manually. In case the command requires interactive input, ask the user to do it themselves and provide them with suitable guidance
+
+### Collaboration Principles
+
+- Always be unbiased towards the code, the user's preference and opinions. If you do not agree with the user, make it clear with them. Treat them like a peer
+- Always mention alternative approaches to the user if you think it's necessary
+- Do not be afraid of hurting the user's feelings or making them feel bad about their skills. Having well-written and maintainable code is significantly more important than cozying up to the user
+- Always give a brief and compact summary of all the changes done
+
+---
+
+## Common Commands
+
+### Development Commands
+
+\`\`\`bash
+pnpm dev
+pnpm build
+pnpm typecheck
+pnpm lint
+\`\`\`
+
+<!-- @feature testing -->
+\`\`\`bash
+pnpm test
+pnpm test:unit
+pnpm test:integration
+\`\`\`
+<!-- @endfeature -->
+
+### Individual Package Commands
+
+\`\`\`bash
+# Web (Next.js on port 3000)
+cd apps/web
+pnpm dev
+pnpm typecheck
+
+# API (Fastify on port 8080)
+cd apps/api
+pnpm dev
+pnpm start
+\`\`\`
+
+### Database Commands (run from \`apps/api\`)
+
+\`\`\`bash
+pnpm db:generate      # Generate Prisma Client
+pnpm db:migrate       # Create and apply migrations
+pnpm db:push          # Push schema changes (no migration files)
+pnpm db:studio        # Open Prisma Studio UI
+pnpm db:seed          # Seed database
+\`\`\`
+
+---
+
+## Coding Standards
+
+### Code Style
+
+- Type Definitions: Prefer \`interface\` for public-facing types and object shapes, \`type\` for unions, intersections, and computed types
+- Use descriptive variable names with auxiliary verbs (\`isLoading\`, \`hasError\`, \`canSubmit\`)
+- Favor default exports for pages and named exports for utilities or functions
+- **IMPORTANT**: Always use import aliases for files in apps. For packages, use relative imports.
+
+### Error Handling
+
+- Use our custom error classes from \`packages/utils/src/errors.ts\`
+- Provide user-friendly error messages and avoid leaking implementation details
+
+---
+
+## Project Architecture
+
+### Packages
+
+- All packages (\`@repo/packages-types\`, \`@repo/packages-utils\`) are consumed directly as TypeScript source files
+- No build or watch required for these packages
+
+### Environment
+
+- Environment variables are managed per-app with Zod validation
+- Web: Only \`NEXT_PUBLIC_*\` variables are exposed to the browser
+- Prisma CLI commands are wrapped with \`dotenv-cli\` to read from \`.env.local\`
+
+### Database
+
+- The API uses Prisma 7 as the ORM with PostgreSQL
+- Prisma queries are automatically logged based on \`LOG_LEVEL\`
+
+### Type Safety & Validation
+
+- The codebase emphasizes runtime and compile-time type safety with **Zod v4 as the single validation library** across the entire stack
+- No class-validator
+
+<!-- @feature testing -->
+### Testing
+
+Unit Tests: \`*.spec.ts\`
+Integration Tests: \`*.integration.spec.ts\`
+<!-- @endfeature -->
+
+### Authentication
+
+- Uses Better Auth
+- When creating users with password auth, set \`accountId\` to the user's email (not user.id)
+
+---
+
+## Web Architecture Patterns
+
+### State Management
+
+- TanStack Query (React Query): For API calls and data synchronization
+- Jotai: For client-side global state (UI state, user preferences)
+
+### API Integration
+
+- API config centralized in \`apps/web/src/lib/api.ts\`
+- **API Response Unwrapping**: The \`api.ts\` fetcher unwraps \`{ data: T }\` to \`T\` but preserves \`{ data: T[], pagination: {...} }\` responses intact
+
+### Authentication & Protected Routes
+
+The web app uses Better Auth for authentication with modern patterns:
+
+- **Auth Client**: Configured in \`apps/web/src/lib/auth.ts\`
+  - Provides \`useSession()\` hook for accessing current user/session
+  - Handles sign in/out, session persistence via cookies
+- **Protected Routes**: \`<ProtectedRoute>\` wrapper component for page-level protection
+
+### UI Component Patterns
+
+- Use Shadcn UI components as base, extend them before creating custom ones
+- Implement thoughtful micro-interactions and hover states wherever needed
+- Use Framer Motion for animations, Lucide React for icons
+- Prefer using \`Skeleton\` components for loading states instead of spinners (especially for data fetching components)
+- Always create a proper loading state for data fetching components.
+- Always use \`cn\` helper for dynamic classnames
+- Never write svg code. Always use existing icons from code or Lucide.
+
+---
+
+## API Architecture Patterns
+
+### Fastify Structure
+
+- The Fastify API follows a plugin-based architecture
+- Validation: Zod schemas directly in route definitions via \`fastify-type-provider-zod\`
+- Dependency Injection: Manual DI via Fastify decorators
+
+### Logging
+
+- The API uses Pino for structured logging with request tracing
+- Verbosity controlled by \`LOG_LEVEL\` env var: \`minimal\` | \`normal\` | \`detailed\` | \`verbose\`
+- **IMPORTANT**: Never use \`console.log\` in the API. Use the logger service instead
+
+**Log Methods:**
+
+- \`logger.info(message, context?)\` - Standard information
+- \`logger.error(message, error?, context?)\` - Errors with automatic Error serialization
+- \`logger.warn(message, context?)\` - Warnings
+- \`logger.debug(message, context?)\` - Debug information (detailed+ level)
+- \`logger.trace(message, context?)\` - Trace logs (verbose level only)
+- \`logger.perf(message, metrics)\` - Performance metrics
+`;
+
+// src/ci-workflow-template.ts
+var CI_WORKFLOW_TEMPLATE = `name: CI
+
+on:
+  push:
+    branches: [main, development]
+  pull_request:
+    branches: [main, development]
+
+# Cancel in-progress runs when a new commit is pushed
+concurrency:
+  group: \${{ github.workflow }}-\${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # Fast checks that can run in parallel
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run lint
+        run: pnpm run lint
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run typecheck
+        run: pnpm run typecheck
+        env:
+          DATABASE_URL: postgresql://user:pass@localhost:5432/db
+
+  # @feature testing
+  # Tests and build run after lint/typecheck pass
+  test:
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck]
+
+    # PostgreSQL service for integration tests
+    services:
+      postgres:
+        image: postgres:17-alpine
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: app_dev_test
+          POSTGRES_HOST_AUTH_METHOD: trust
+        options: >-
+          --health-cmd "pg_isready -U postgres"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5432:5432
+
+    env:
+      NODE_ENV: test
+      DATABASE_URL: postgresql://postgres:postgres@localhost:5432/app_dev
+      API_URL: http://localhost:8080
+      FRONTEND_URL: http://localhost:3000
+      PORT: 8080
+      LOG_LEVEL: minimal
+      COOKIE_SECRET: test-cookie-secret-for-ci
+      BETTER_AUTH_SECRET: test-secret-minimum-32-characters-long-for-ci
+      BETTER_AUTH_URL: http://localhost:8080
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Generate Prisma Client
+        run: cd apps/api && npx prisma generate
+
+      - name: Run tests
+        run: pnpm run test
+  # @endfeature
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Generate Prisma Client
+        run: pnpm --filter @repo/api db:generate
+        env:
+          DATABASE_URL: postgresql://user:pass@localhost:5432/db
+
+      - name: Setup Turborepo cache
+        uses: actions/cache@v4
+        with:
+          path: .turbo
+          key: \${{ runner.os }}-turbo-\${{ github.sha }}
+          restore-keys: |
+            \${{ runner.os }}-turbo-
+
+      - name: Build
+        run: pnpm run build
+        env:
+          NODE_ENV: production
+          API_URL: 'http://localhost:8080'
+          FRONTEND_URL: 'http://localhost:3000'
+          DATABASE_URL: 'postgresql://user:pass@localhost:5432/db'
+          PORT: '8080'
+          LOG_LEVEL: 'minimal'
+          COOKIE_SECRET: 'ci-test-secret-not-for-production'
+          BETTER_AUTH_SECRET: 'test-secret-minimum-32-characters-long-for-ci'
+          BETTER_AUTH_URL: 'http://localhost:8080'
+          NEXT_PUBLIC_API_URL: 'http://localhost:8080/api'
+`;
+
+// src/transform.ts
 var TESTING_SCRIPTS = [
   "test",
   "test:unit",
@@ -628,6 +979,16 @@ var TESTING_ROOT_DEVDEPS = [
 ];
 var TESTING_APP_DEVDEPS = ["vitest", "vite-tsconfig-paths"];
 var UPLOADS_API_DEPS = ["@aws-sdk/client-s3", "sharp"];
+var TESTING_DIR_NAMES = /* @__PURE__ */ new Set(["__tests__", "test", "tests"]);
+var TESTING_FILE_PATTERNS = [
+  /\.test\.[^/]+$/i,
+  /\.spec\.[^/]+$/i,
+  /^vitest(?:\.[^.]+)*\.(?:[cm]?[jt]sx?)$/i,
+  /^test-config\.(?:[cm]?[jt]sx?)$/i
+];
+var TS_CONFIG_FILE_PATTERN = /^tsconfig(?:\.[^.]+)?\.json$/;
+var AGENT_DOC_TARGETS = ["CLAUDE.md", "AGENTS.md"];
+var CI_WORKFLOW_RELATIVE_PATH = ".github/workflows/ci.yml";
 var MARKER_FILES = [
   "apps/api/src/app.ts",
   "apps/api/src/plugins/services.ts",
@@ -637,22 +998,23 @@ 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/);
+    const featureStart = line.match(
+      /^\s*(?:\/\/|#|<!--)\s*@feature\s+(\w+)\s*(?:-->)?\s*$/
+    );
+    const featureEnd = line.match(
+      /^\s*(?:\/\/|#|<!--)\s*@endfeature\s*(?:-->)?\s*$/
+    );
     if (featureStart) {
       const feature = featureStart[1];
       if (disabledFeatures.includes(feature)) {
         skipUntilEnd = true;
-        currentFeature = feature;
       }
       continue;
     }
     if (featureEnd) {
       if (skipUntilEnd) {
         skipUntilEnd = false;
-        currentFeature = null;
       }
       continue;
     }
@@ -800,6 +1162,8 @@ async function applyFeatureTransforms(targetDir, features) {
   if (!features.testing) disabledFeatures.push("testing");
   if (!features.admin) disabledFeatures.push("admin");
   if (!features.uploads) disabledFeatures.push("uploads");
+  if (!features.dockerDeploy) disabledFeatures.push("dockerDeploy");
+  if (!features.ciCd) disabledFeatures.push("ciCd");
   for (const relativePath of MARKER_FILES) {
     const filePath = path3.join(targetDir, relativePath);
     if (await fs2.pathExists(filePath)) {
@@ -812,8 +1176,13 @@ async function applyFeatureTransforms(targetDir, features) {
   if (!features.testing) {
     await transformForNoTesting(targetDir);
   }
+  await transformCiWorkflow(targetDir, disabledFeatures);
+  await transformAgentDocs(targetDir, disabledFeatures);
 }
 async function transformForNoTesting(targetDir) {
+  await removeTestingArtifacts(targetDir);
+  await stripTestingFromWorkspacePackageJson(targetDir);
+  await stripTestingFromTsConfigs(targetDir);
   const turboPath = path3.join(targetDir, "turbo.json");
   if (await fs2.pathExists(turboPath)) {
     const content = await fs2.readFile(turboPath, "utf-8");
@@ -823,6 +1192,7 @@ async function transformForNoTesting(targetDir) {
     delete turbo.tasks?.["test:integration"];
     delete turbo.tasks?.["test:watch"];
     delete turbo.tasks?.["test:coverage"];
+    delete turbo.tasks?.["test:parallel"];
     await fs2.writeFile(turboPath, JSON.stringify(turbo, null, 2) + "\n");
   }
   const huskyPath = path3.join(targetDir, ".husky/pre-push");
@@ -830,6 +1200,156 @@ async function transformForNoTesting(targetDir) {
     await fs2.writeFile(huskyPath, "pnpm typecheck\n");
   }
 }
+function isTestingDependency(name) {
+  return name === "vitest" || name.startsWith("@vitest/") || name.startsWith("@testing-library/") || name === "jsdom" || name === "vite-tsconfig-paths";
+}
+function isTestingIncludeEntry(value) {
+  return value.includes("__tests__") || value.includes("/test") || value.includes("test/") || value.includes("tests/") || value.includes(".test.") || value.includes(".spec.");
+}
+async function removeTestingArtifacts(currentDir) {
+  const entries = await fs2.readdir(currentDir);
+  for (const entry of entries) {
+    if (entry === ".git" || entry === "node_modules") {
+      continue;
+    }
+    const fullPath = path3.join(currentDir, entry);
+    const stat = await fs2.stat(fullPath);
+    if (stat.isDirectory()) {
+      if (TESTING_DIR_NAMES.has(entry)) {
+        await fs2.remove(fullPath);
+        continue;
+      }
+      await removeTestingArtifacts(fullPath);
+      continue;
+    }
+    if (TESTING_FILE_PATTERNS.some((pattern) => pattern.test(entry))) {
+      await fs2.remove(fullPath);
+    }
+  }
+}
+async function stripTestingFromWorkspacePackageJson(currentDir) {
+  const entries = await fs2.readdir(currentDir);
+  for (const entry of entries) {
+    if (entry === ".git" || entry === "node_modules") {
+      continue;
+    }
+    const fullPath = path3.join(currentDir, entry);
+    const stat = await fs2.stat(fullPath);
+    if (stat.isDirectory()) {
+      await stripTestingFromWorkspacePackageJson(fullPath);
+      continue;
+    }
+    if (entry !== "package.json") {
+      continue;
+    }
+    const content = await fs2.readFile(fullPath, "utf-8");
+    const pkg = JSON.parse(content);
+    let changed = false;
+    if (pkg.scripts && typeof pkg.scripts === "object") {
+      for (const scriptName of Object.keys(pkg.scripts)) {
+        if (scriptName === "test" || scriptName.startsWith("test:")) {
+          delete pkg.scripts[scriptName];
+          changed = true;
+        }
+      }
+    }
+    const dependencySections = [
+      "dependencies",
+      "devDependencies",
+      "peerDependencies",
+      "optionalDependencies"
+    ];
+    for (const section of dependencySections) {
+      if (!pkg[section] || typeof pkg[section] !== "object") {
+        continue;
+      }
+      for (const depName of Object.keys(pkg[section])) {
+        if (isTestingDependency(depName)) {
+          delete pkg[section][depName];
+          changed = true;
+        }
+      }
+    }
+    if ("vitest" in pkg) {
+      delete pkg.vitest;
+      changed = true;
+    }
+    if (changed) {
+      await fs2.writeFile(fullPath, JSON.stringify(pkg, null, 2) + "\n");
+    }
+  }
+}
+async function stripTestingFromTsConfigs(currentDir) {
+  const entries = await fs2.readdir(currentDir);
+  for (const entry of entries) {
+    if (entry === ".git" || entry === "node_modules") {
+      continue;
+    }
+    const fullPath = path3.join(currentDir, entry);
+    const stat = await fs2.stat(fullPath);
+    if (stat.isDirectory()) {
+      await stripTestingFromTsConfigs(fullPath);
+      continue;
+    }
+    if (!TS_CONFIG_FILE_PATTERN.test(entry)) {
+      continue;
+    }
+    const content = await fs2.readFile(fullPath, "utf-8");
+    const tsconfig = JSON.parse(content);
+    let changed = false;
+    const compilerOptions = tsconfig.compilerOptions;
+    if (compilerOptions && typeof compilerOptions === "object") {
+      if (Array.isArray(compilerOptions.types)) {
+        const nextTypes = compilerOptions.types.filter(
+          (value) => typeof value === "string" && !value.includes("vitest") && !value.includes("@testing-library")
+        );
+        if (nextTypes.length !== compilerOptions.types.length) {
+          compilerOptions.types = nextTypes;
+          changed = true;
+        }
+      }
+      if (compilerOptions.paths && typeof compilerOptions.paths === "object") {
+        if ("@test/*" in compilerOptions.paths) {
+          delete compilerOptions.paths["@test/*"];
+          changed = true;
+        }
+        if ("@tests/*" in compilerOptions.paths) {
+          delete compilerOptions.paths["@tests/*"];
+          changed = true;
+        }
+      }
+    }
+    if (Array.isArray(tsconfig.include)) {
+      const nextInclude = tsconfig.include.filter(
+        (value) => typeof value === "string" && !isTestingIncludeEntry(value)
+      );
+      if (nextInclude.length !== tsconfig.include.length) {
+        tsconfig.include = nextInclude;
+        changed = true;
+      }
+    }
+    if (changed) {
+      await fs2.writeFile(fullPath, JSON.stringify(tsconfig, null, 2) + "\n");
+    }
+  }
+}
+async function transformAgentDocs(targetDir, disabledFeatures) {
+  let content = stripFeatureBlocks(AGENT_DOC_TEMPLATE, disabledFeatures);
+  content = cleanEmptyLines(content).trimEnd() + "\n";
+  for (const fileName of AGENT_DOC_TARGETS) {
+    const filePath = path3.join(targetDir, fileName);
+    const heading = fileName === "AGENTS.md" ? "# AGENTS.md" : "# CLAUDE.md";
+    const fileContent = content.replace(/^#\s+CLAUDE\.md/m, heading);
+    await fs2.writeFile(filePath, fileContent, "utf-8");
+  }
+}
+async function transformCiWorkflow(targetDir, disabledFeatures) {
+  const workflowPath = path3.join(targetDir, CI_WORKFLOW_RELATIVE_PATH);
+  await fs2.ensureDir(path3.dirname(workflowPath));
+  let content = stripFeatureBlocks(CI_WORKFLOW_TEMPLATE, disabledFeatures);
+  content = cleanEmptyLines(content).trimEnd() + "\n";
+  await fs2.writeFile(workflowPath, content, "utf-8");
+}
 
 // src/commands/create.ts
 var ENV_FILES = [

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "create-blitzpack",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Create a new Blitzpack project - full-stack TypeScript monorepo with Next.js and Fastify",
   "type": "module",
   "bin": {
-    "create-blitzpack": "./dist/index.js"
+    "create-blitzpack": "dist/index.js"
   },
   "files": [
     "dist"
@@ -47,7 +47,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/CarboxyDev/blitzpack"
+    "url": "git+https://github.com/CarboxyDev/blitzpack.git"
   },
   "homepage": "https://github.com/CarboxyDev/blitzpack",
   "engines": {