create-blitzpack 0.1.0 → 0.1.1

package/dist/index.js

@@ -9,7 +9,6 @@ import { spawn } from "child_process";
 import fs3 from "fs-extra";
 import ora from "ora";
 import path3 from "path";
-import { fileURLToPath } from "url";
 
 // src/git.ts
 import { execSync } from "child_process";
@@ -39,28 +38,6 @@ function initGit(targetDir) {
 import prompts from "prompts";
 
 // src/constants.ts
-var TEMPLATE_EXCLUDES = [
-  "node_modules",
-  ".next",
-  ".turbo",
-  "dist",
-  "build",
-  "coverage",
-  ".git",
-  "pnpm-lock.yaml",
-  "*.tsbuildinfo",
-  "tsconfig.tsbuildinfo",
-  ".env.local",
-  ".env.*.local",
-  ".DS_Store",
-  ".temp",
-  ".claude",
-  ".cursor",
-  "create-blitzpack",
-  "apps/api/src/generated",
-  "apps/api/public/uploads",
-  "scripts/setup.js"
-];
 var REPLACEABLE_FILES = [
   "package.json",
   "apps/web/src/config/site.ts",
@@ -178,47 +155,28 @@ async function getProjectOptions(providedName, flags = {}) {
 
 // src/template.ts
 import fs from "fs-extra";
+import { downloadTemplate } from "giget";
 import path from "path";
-function shouldExclude(relativePath) {
-  const normalizedPath = relativePath.replace(/\\/g, "/");
-  for (const pattern of TEMPLATE_EXCLUDES) {
-    if (pattern.startsWith("*")) {
-      const ext = pattern.slice(1);
-      if (normalizedPath.endsWith(ext)) return true;
-    } else if (normalizedPath === pattern || normalizedPath.startsWith(pattern + "/")) {
-      return true;
-    } else {
-      const parts = normalizedPath.split("/");
-      if (parts.includes(pattern)) return true;
-    }
-  }
-  return false;
-}
-async function copyDir(src, dest, baseDir) {
-  await fs.ensureDir(dest);
-  const entries = await fs.readdir(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    const relativePath = path.relative(baseDir, srcPath);
-    if (shouldExclude(relativePath)) {
-      continue;
-    }
-    if (entry.isDirectory()) {
-      await copyDir(srcPath, destPath, baseDir);
-    } else {
-      await fs.copy(srcPath, destPath);
+var GITHUB_REPO = "github:CarboxyDev/blitzpack";
+var POST_DOWNLOAD_EXCLUDES = [
+  "create-blitzpack",
+  "scripts/setup.js",
+  ".github"
+];
+async function cleanupExcludes(targetDir) {
+  for (const exclude of POST_DOWNLOAD_EXCLUDES) {
+    const fullPath = path.join(targetDir, exclude);
+    if (await fs.pathExists(fullPath)) {
+      await fs.remove(fullPath);
     }
   }
 }
-async function copyTemplate(templateDir, targetDir) {
-  if (await fs.pathExists(targetDir)) {
-    const files = await fs.readdir(targetDir);
-    if (files.length > 0) {
-      throw new Error(`Directory ${targetDir} is not empty`);
-    }
-  }
-  await copyDir(templateDir, targetDir, templateDir);
+async function downloadAndPrepareTemplate(targetDir) {
+  await downloadTemplate(GITHUB_REPO, {
+    dir: targetDir,
+    force: true
+  });
+  await cleanupExcludes(targetDir);
 }
 
 // src/transform.ts
@@ -237,10 +195,16 @@ function transformPackageJson(content, vars, filePath) {
   return JSON.stringify(pkg, null, 2) + "\n";
 }
 function transformSiteConfig(content, vars) {
-  return content.replace(/name: ['"].*['"]/, `name: '${vars.projectName}'`).replace(/description: ['"].*['"]/, `description: '${vars.projectDescription}'`).replace(/github: ['"].*['"]/, `github: ''`);
+  return content.replace(/name: ['"].*['"]/, `name: '${vars.projectName}'`).replace(
+    /description: ['"].*['"]/,
+    `description: '${vars.projectDescription}'`
+  ).replace(/github: ['"].*['"]/, `github: ''`);
 }
 function transformLayout(content, vars) {
-  return content.replace(/title: ['"].*['"]/, `title: '${vars.projectName}'`).replace(/description: ['"].*['"]/, `description: '${vars.projectDescription}'`);
+  return content.replace(/title: ['"].*['"]/, `title: '${vars.projectName}'`).replace(
+    /description: ['"].*['"]/,
+    `description: '${vars.projectDescription}'`
+  );
 }
 function transformSwagger(content, vars) {
   return content.replace(/title: ['"].*['"]/, `title: '${vars.projectName} API'`).replace(
@@ -319,7 +283,6 @@ async function transformFiles(targetDir, vars) {
 }
 
 // src/commands/create.ts
-var __dirname = path3.dirname(fileURLToPath(import.meta.url));
 var ENV_FILES = [
   { from: "apps/web/.env.local.example", to: "apps/web/.env.local" },
   { from: "apps/api/.env.local.example", to: "apps/api/.env.local" }
@@ -358,7 +321,7 @@ function printDryRun(options) {
   console.log();
   console.log(chalk2.bold("  Would run:"));
   console.log();
-  console.log(`    ${chalk2.dim("\u2022")} Copy template files`);
+  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`);
   if (!options.skipGit) {
@@ -394,18 +357,11 @@ async function create(projectName, flags) {
       return;
     }
   }
-  const templateDir = path3.resolve(__dirname, "..", "template");
-  if (!await fs3.pathExists(templateDir)) {
-    printError(
-      "Template directory not found. This is a bug in create-blitzpack."
-    );
-    return;
-  }
   const spinner = ora();
   try {
-    spinner.start("Creating project structure...");
-    await copyTemplate(templateDir, targetDir);
-    spinner.succeed("Created project structure");
+    spinner.start("Downloading template from GitHub...");
+    await downloadAndPrepareTemplate(targetDir);
+    spinner.succeed("Downloaded template");
     spinner.start("Configuring project...");
     await transformFiles(targetDir, {
       projectName: options.projectName,
@@ -446,7 +402,9 @@ async function create(projectName, flags) {
 
 // src/index.ts
 var program = new Command();
-program.name("create-blitzpack").description("Create a new Blitzpack project").version("0.1.0").argument("[project-name]", "Name of the project").option("--skip-git", "Skip git initialization").option("--skip-install", "Skip dependency installation").option("--dry-run", "Show what would be done without making changes").action(async (projectName, options) => {
-  await create(projectName, options);
-});
+program.name("create-blitzpack").description("Create a new Blitzpack project").version("0.1.0").argument("[project-name]", "Name of the project").option("--skip-git", "Skip git initialization").option("--skip-install", "Skip dependency installation").option("--dry-run", "Show what would be done without making changes").action(
+  async (projectName, options) => {
+    await create(projectName, options);
+  }
+);
 program.parse();

package/package.json

@@ -1,26 +1,25 @@
 {
   "name": "create-blitzpack",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Create a new Blitzpack project - full-stack TypeScript monorepo with Next.js and Fastify",
   "type": "module",
   "bin": {
     "create-blitzpack": "./dist/index.js"
   },
   "files": [
-    "dist",
-    "template"
+    "dist"
   ],
   "scripts": {
     "dev": "tsup --watch",
-    "build": "pnpm run build:template && tsup",
-    "build:template": "node scripts/copy-template.js",
+    "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist template"
+    "clean": "rm -rf dist"
   },
   "dependencies": {
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "fs-extra": "^11.3.0",
+    "giget": "^2.0.0",
     "ora": "^8.2.0",
     "prompts": "^2.4.2",
     "validate-npm-package-name": "^6.0.0"

package/template/.dockerignore

@@ -1,59 +0,0 @@
-# Dependencies
-node_modules
-npm-debug.log
-pnpm-debug.log
-yarn-error.log
-
-# Build outputs (but keep package dist/ folders for copying built packages)
-# We ignore these initially but packages/*/dist will be built during Docker build
-.next
-.turbo
-*.tsbuildinfo
-apps/*/dist
-
-# Testing
-coverage
-.vitest
-
-# Environment files (never include in image)
-.env
-.env.local
-.env.*.local
-.env.development
-.env.production
-
-# Git
-.git
-.gitignore
-.github
-
-# IDE
-.vscode
-.idea
-*.swp
-*.swo
-*~
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Logs
-logs
-*.log
-
-# Documentation (not needed in production)
-README.md
-DEPLOYMENT.md
-CLAUDE.md
-*.md
-
-# Docker
-Dockerfile
-.dockerignore
-docker-compose.yml
-
-# Misc
-.husky
-scripts
-# Keep config/ for package builds

package/template/.github/workflows/ci.yml

@@ -1,157 +0,0 @@
-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: Create .env for Prisma
-        run: echo "DATABASE_URL=postgresql://user:pass@localhost:5432/db" > apps/api/.env
-
-      - name: Generate Prisma Client
-        run: pnpm --filter @repo/api db:generate
-
-      - name: Run typecheck
-        run: pnpm run typecheck --filter '!@repo/api' # FIXME: Temporary workaround because of prisma v7 issues
-
-  # 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
-
-  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
-
-      - 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: 'ci-test-secret-not-for-production'
-          BETTER_AUTH_URL: 'http://localhost:8080'
-          NEXT_PUBLIC_API_URL: 'http://localhost:8080/api'

package/template/.husky/pre-commit

@@ -1 +0,0 @@
-pnpm lint-staged

package/template/.husky/pre-push

@@ -1 +0,0 @@
-pnpm typecheck && pnpm test

package/template/.lintstagedrc.cjs

@@ -1,4 +0,0 @@
-module.exports = {
-  '*.{ts,tsx,js,jsx}': ['eslint --fix', 'prettier --write'],
-  '*.{json,md,yml,yaml}': ['prettier --write'],
-};

package/template/.nvmrc

@@ -1 +0,0 @@
-20.0.0

package/template/.prettierrc

@@ -1,9 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "es5",
-  "singleQuote": true,
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false,
-  "plugins": ["prettier-plugin-tailwindcss"]
-}

package/template/.vscode/settings.json

@@ -1,13 +0,0 @@
-{
-  "editor.formatOnSave": true,
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit"
-  },
-  "eslint.workingDirectories": [{ "mode": "auto" }],
-  "typescript.tsdk": "node_modules/typescript/lib",
-  "typescript.enablePromptUseWorkspaceTsdk": true,
-  "typescript.preferences.includePackageJsonAutoImports": "on",
-  "typescript.validate.enable": true,
-  "prisma.pinToPrisma6": false
-}

package/template/CLAUDE.md

@@ -1,175 +0,0 @@
-# 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 test
-pnpm test:unit
-pnpm test:integration
-pnpm lint
-```
-
-### 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
-
-### Testing
-
-Unit Tests: `*.spec.ts`
-Integration Tests: `*.integration.spec.ts`
-
-### Authentication
-
-- Uses Better Auth
-- When creating test 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 class name merging
-- 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

package/template/CONTRIBUTING.md

@@ -1,32 +0,0 @@
-# Contributing to Blitzpack
-
-Thank you for your interest in contributing! This is a TypeScript monorepo template designed to help developers ship full-stack applications super fast.
-
----
-
-## Setup
-
-1. Fork and clone the repository
-2. Run `pnpm install && pnpm init:project`
-3. Start development: `pnpm dev`
-
-## Development
-
-1. Create a feature branch: `git checkout -b feature/your-feature`
-2. Make changes following the code style in `CLAUDE.md`
-3. Run checks: `pnpm typecheck && pnpm lint && pnpm test && pnpm build`
-4. Commit like a sane person
-5. Push and create a Pull request
-
-## Code Style
-
-- Follow patterns in `CLAUDE.md`
-- Always use import aliases (`@/...`)
-
-## Pull Requests
-
-- Rebase on latest main before submitting
-- Ensure all CI checks pass
-- Update documentation if needed
-
-For detailed architecture and patterns, see `CLAUDE.md`.