create-blitzpack 0.1.0 → 0.1.1

package/template/Dockerfile

@@ -1,90 +0,0 @@
-# Multi-stage Dockerfile for API deployment
-# Optimized for pnpm monorepo with Prisma
-
-# Stage 1: Dependencies
-FROM node:22-alpine AS deps
-RUN apk add --no-cache libc6-compat openssl
-
-# Install pnpm
-RUN corepack enable && corepack prepare pnpm@9.15.4 --activate
-
-WORKDIR /app
-
-# Copy workspace files
-COPY pnpm-workspace.yaml package.json pnpm-lock.yaml ./
-
-# Copy all package.json files for workspace dependencies
-COPY apps/api/package.json apps/api/
-COPY packages/types/package.json packages/types/
-COPY packages/utils/package.json packages/utils/
-
-# Install dependencies (frozen lockfile for reproducible builds)
-RUN pnpm install --frozen-lockfile --prod=false
-
-# Stage 2: Builder
-FROM node:22-alpine AS builder
-RUN apk add --no-cache libc6-compat openssl
-
-RUN corepack enable && corepack prepare pnpm@9.15.4 --activate
-
-WORKDIR /app
-
-# Copy installed dependencies from deps stage
-COPY --from=deps /app/node_modules ./node_modules
-COPY --from=deps /app/apps/api/node_modules ./apps/api/node_modules
-COPY --from=deps /app/packages/types/node_modules ./packages/types/node_modules
-COPY --from=deps /app/packages/utils/node_modules ./packages/utils/node_modules
-
-# Copy source code
-COPY . .
-
-# Build shared packages first (types and utils)
-RUN pnpm --filter @repo/packages-types build
-RUN pnpm --filter @repo/packages-utils build
-
-# Generate Prisma Client
-RUN pnpm --filter @repo/api db:generate
-
-# Build the API
-RUN pnpm --filter @repo/api build
-
-# Stage 3: Runner (production)
-FROM node:22-alpine AS runner
-RUN apk add --no-cache openssl
-
-RUN corepack enable && corepack prepare pnpm@9.15.4 --activate
-
-WORKDIR /app
-
-# Create non-root user for security
-RUN addgroup --system --gid 1001 nodejs && \
-    adduser --system --uid 1001 fastify
-
-# Copy necessary files from builder
-COPY --from=builder --chown=fastify:nodejs /app/apps/api/dist ./apps/api/dist
-COPY --from=builder --chown=fastify:nodejs /app/apps/api/package.json ./apps/api/
-COPY --from=builder --chown=fastify:nodejs /app/apps/api/prisma ./apps/api/prisma
-COPY --from=builder --chown=fastify:nodejs /app/apps/api/start.sh ./apps/api/
-COPY --from=builder --chown=fastify:nodejs /app/packages ./packages
-COPY --from=builder --chown=fastify:nodejs /app/node_modules ./node_modules
-COPY --from=builder --chown=fastify:nodejs /app/apps/api/node_modules ./apps/api/node_modules
-COPY --from=builder --chown=fastify:nodejs /app/package.json ./package.json
-COPY --from=builder --chown=fastify:nodejs /app/pnpm-workspace.yaml ./pnpm-workspace.yaml
-
-# Make start script executable
-RUN chmod +x /app/apps/api/start.sh
-
-# Switch to non-root user
-USER fastify
-
-WORKDIR /app/apps/api
-
-# Expose the API port
-EXPOSE 8080
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
-  CMD node -e "require('http').get('http://localhost:8080/health', (r) => {process.exit(r.statusCode === 200 ? 0 : 1)})"
-
-# Start command (handles database wake-up, runs migrations, then starts server)
-CMD ["/app/apps/api/start.sh"]

package/template/GETTING_STARTED.md

@@ -1,35 +0,0 @@
-# Blitzpack Template Setup
-
-After clicking "Use this template" and cloning your repository:
-
-## Quick Start (Use As-Is)
-
-```bash
-pnpm install
-pnpm init:project
-pnpm dev
-```
-
-**That's it!** The template works out of the box. Customize when ready.
-
-## When You're Ready to Customize
-
-### Update Branding
-
-- `apps/web/src/config/site.ts` → Project name, description, GitHub URL
-- `README.md` → Replace Blitzpack README.md with yours
-
-### Optional: Change Database Credentials
-
-Default credentials: `postgres/postgres_dev_password/app_dev`
-
-To use different credentials:
-
-1. Update `docker-compose.yml` (POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB)
-2. Update `apps/api/.env.local` (DATABASE_URL must match step 1)
-3. Restart Docker: `docker compose down && docker compose up -d`
-4. Run migrations: `pnpm --filter @repo/api db:migrate`
-
----
-
-**Delete this file when done.**

package/template/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Arman Ganjoo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/template/README.md

@@ -1,116 +0,0 @@
-<div align="center">
-  <img src="assets/logo.svg" alt="Blitzpack Logo" width="200">
-  <h1>Blitzpack</h1>
-  <p>Full-stack TypeScript monorepo template with Next.js, Fastify, and Turborepo. From zero to production in minutes.</p>
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Node.js](https://img.shields.io/badge/Node.js-≥20.0.0-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
-[![pnpm](https://img.shields.io/badge/pnpm-≥9.0.0-F69220?logo=pnpm&logoColor=white)](https://pnpm.io/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-[![CI](https://github.com/CarboxyDev/blitzpack/actions/workflows/ci.yml/badge.svg)](https://github.com/CarboxyDev/blitzpack/actions/workflows/ci.yml)
-
-</div>
-
----
-
-## Why Blitzpack?
-
-Stop wasting days bootstrapping your next project. Most templates hand you a skeleton and leave you to figure out database migrations, API documentation, logging infrastructure, and much more. Blitzpack ships with all of it configured and working. You just need to run a single script to get started with a production-ready full-stack application.
-
-**Ship your next project faster with battle-tested infrastructure already wired up.**
-
-- **Zero-config setup**: Run one command and you're ready to code. Environment files, Docker containers, database migrations—all handled automatically.
-
-- **Full-stack type safety**: Zod schemas define your API contracts once in `packages/types`, then flow automatically to web forms, API validation, and database queries. No duplicate validation logic.
-
-- **Production-grade infrastructure**: Better-auth with session management and OAuth ready. Request ID tracing, automatic validation, rate limiting, structured logging, and environment-aware error responses out of the box.
-
-- **AI pair programming ready**: Comprehensive CLAUDE.md file means AI assistants understand your architecture instantly and can accelerate your development.
-
-## Tech Stack
-
-**Web:** Next.js, React, TanStack Query, Tailwind CSS
-
-**Backend:** Fastify, Prisma, PostgreSQL
-
-**Monorepo:** Turborepo, pnpm workspaces
-
-<details>
-<summary>Full stack details</summary>
-
-<p>
-
-**Web**
-
-- Next.js 16 + React 19
-- TanStack Query v5 for server state
-- shadcn/ui + Tailwind CSS v4
-- React Hook Form + Zod validation
-- Jotai for client state
-
-**API**
-
-- Fastify 5
-- Prisma 7 + PostgreSQL 17
-- Better-auth for authentication
-- Pino for logging
-- Scalar API docs
-- Helmet + rate limiting
-
-**Monorepo**
-
-- pnpm workspaces + Turborepo
-- Shared packages for types, utils, config in `packages/`
-- Vitest for testing
-- Husky + lint-staged for pre-commit hooks
-</p>
-</details>
-
-## Quick Start
-
-```bash
-# Install dependencies
-pnpm install
-
-# Automated setup (creates .env files, starts docker, runs migrations)
-pnpm init:project
-
-# Start development
-pnpm dev
-```
-
-The setup script handles everything: environment files, docker containers, database migrations, and optional seeding. Safe to run multiple times.
-
-You must have docker installed and running on your machine.
-
-**What's running:**
-
-- Web: [http://localhost:3000](http://localhost:3000)
-- API: [http://localhost:8080/api](http://localhost:8080/api)
-- API Docs: [http://localhost:8080/docs](http://localhost:8080/docs)
-- Health Check: [http://localhost:8080/health](http://localhost:8080/health)
-
-**Database tools:**
-
-- Prisma Studio: Run `pnpm db:studio` to open [http://localhost:5555](http://localhost:5555) (recommended for data inspection)
-
-**Built-in pages:**
-
-- `/examples` - Component examples
-- `/dashboard` - Protected user dashboard
-- `/login` - Sign in page
-- `/signup` - Create new account
-- `/forgot-password` - Forgot password page
-- `/reset-password` - Reset password page
-
-## Project Structure
-
-```
-blitzpack/
-├── apps/
-│   ├── web/          # Next.js app
-│   └── api/          # Fastify API
-└── packages/
-    ├── types/        # Zod schemas + inferred types
-    └── utils/        # Shared utilities
-```

package/template/apps/api/.dockerignore

@@ -1,51 +0,0 @@
-# Dependencies
-node_modules
-.pnpm-store
-
-# Build outputs
-dist
-build
-.next
-*.tsbuildinfo
-
-# Development files
-.env
-.env.local
-.env.*.local
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-
-# Testing
-coverage
-test-results
-.vitest
-
-# IDE
-.vscode
-.idea
-*.swp
-*.swo
-.DS_Store
-
-# Git
-.git
-.gitignore
-.gitattributes
-
-# Documentation
-*.md
-!README.md
-
-# CI/CD
-.github
-.gitlab-ci.yml
-.travis.yml
-
-# Misc
-.cache
-.temp
-tmp
-temp

package/template/apps/api/.env.local.example

@@ -1,62 +0,0 @@
-NODE_ENV=development
-API_URL=http://localhost:8080
-FRONTEND_URL=http://localhost:3000
-PORT=8080
-
-# Database connection string for local Docker PostgreSQL
-# Match credentials from docker-compose.yml
-# Note: Test database will automatically use app_dev_test (suffix added by test runner)
-DATABASE_URL=postgresql://postgres:postgres_dev_password@localhost:5432/app_dev
-
-
-# Cookie secret for signing cookies
-COOKIE_SECRET=dev-secret-change-in-production-use-random-string
-
-# Logging verbosity level
-# - minimal: Only errors and critical warnings (recommended for production)
-# - normal: Standard HTTP requests, business events, errors (default)
-# - detailed: Include debug info, SQL queries, cache operations
-# - verbose: Everything including request/response bodies, timing breakdowns
-LOG_LEVEL=normal
-
-# Better Auth configuration
-BETTER_AUTH_SECRET=dev-secret-change-in-production-must-be-at-least-32-characters
-# Base URL of your API for Better Auth callbacks
-BETTER_AUTH_URL=http://localhost:8080
-
-
-
-# Email Service Configuration
-# You MUST verify your domain in Resend dashboard before sending emails
-RESEND_API_KEY=re_xxxxxxxxxxxx
-EMAIL_FROM=noreply@yourdomain.com
-
-# OAuth Provider Credentials (Optional but recommended)
-# Google and GitHub OAuth are enabled by default.
-# Google OAuth Setup:
-# 1. Go to: https://console.cloud.google.com/apis/credentials
-# 2. Create OAuth 2.0 Client ID (Web application)
-# 3. Add authorized redirect URI: http://localhost:8080/api/auth/callback/google
-# 4. For production, add: https://<domain>.com/api/auth/callback/google
-GOOGLE_CLIENT_ID=
-GOOGLE_CLIENT_SECRET=
-
-
-# GitHub OAuth Setup:
-# 1. Go to: https://github.com/settings/developers
-# 2. Create new OAuth App
-# 3. Set Authorization callback URL: http://localhost:8080/api/auth/callback/github
-# 4. For production, add: https://<domain>.com/api/auth/callback/github
-GITHUB_CLIENT_ID=
-GITHUB_CLIENT_SECRET=
-
-
-# File Storage Configuration (OPTIONAL)
-# Defaults to local file storage if not configured
-# For S3-compatible storage (AWS S3, Cloudflare R2, MinIO, etc.)
-# STORAGE_TYPE=local
-# S3_BUCKET=
-# S3_REGION=auto
-# S3_ACCESS_KEY_ID=
-# S3_SECRET_ACCESS_KEY=
-# S3_ENDPOINT=https://your-account-id.r2.cloudflarestorage.com

package/template/apps/api/emails/account-deleted-email.tsx

@@ -1,69 +0,0 @@
-import { Link, Text } from '@react-email/components';
-import * as React from 'react';
-
-import { EmailLayout } from './components/email-layout';
-import { emailConfig } from './config';
-
-interface AccountDeletedEmailProps {
-  userEmail: string;
-  deletedAt: string;
-}
-
-export default function AccountDeletedEmail({
-  userEmail = 'user@example.com',
-  deletedAt = new Date().toLocaleString('en-US', {
-    dateStyle: 'medium',
-    timeStyle: 'short',
-  }),
-}: AccountDeletedEmailProps) {
-  const { appName, supportEmail } = emailConfig;
-
-  return (
-    <EmailLayout
-      preview={`Your ${appName} account has been deleted`}
-      heading="Account deleted"
-    >
-      <Text style={paragraph}>
-        Your account (<strong>{userEmail}</strong>) has been permanently deleted
-        on {deletedAt}.
-      </Text>
-
-      <Text style={paragraph}>
-        All your data has been removed from our systems. This action cannot be
-        undone.
-      </Text>
-
-      <Text style={paragraph}>
-        If you didn't request this deletion or believe this was done in error,
-        please contact us immediately at{' '}
-        <Link href={`mailto:${supportEmail}`} style={link}>
-          {supportEmail}
-        </Link>
-        .
-      </Text>
-
-      <Text style={paragraphSmall}>
-        Thank you for being part of {appName}. We're sorry to see you go.
-      </Text>
-    </EmailLayout>
-  );
-}
-
-const paragraph: React.CSSProperties = {
-  color: '#334155',
-  fontSize: '15px',
-  lineHeight: '24px',
-  margin: '0 0 24px',
-};
-
-const paragraphSmall: React.CSSProperties = {
-  color: '#94a3b8',
-  fontSize: '13px',
-  lineHeight: '20px',
-  margin: '24px 0 0',
-};
-
-const link: React.CSSProperties = {
-  color: '#2563eb',
-  textDecoration: 'underline',
-};

package/template/apps/api/emails/components/email-layout.tsx

@@ -1,154 +0,0 @@
-import {
-  Body,
-  Container,
-  Head,
-  Heading,
-  Hr,
-  Html,
-  Img,
-  Link,
-  Preview,
-  Section,
-  Text,
-} from '@react-email/components';
-import * as React from 'react';
-
-import { emailConfig } from '../config';
-
-interface EmailLayoutProps {
-  preview: string;
-  heading: string;
-  children: React.ReactNode;
-  showFooterLinks?: boolean;
-}
-
-export function EmailLayout({
-  preview,
-  heading,
-  children,
-  showFooterLinks = true,
-}: EmailLayoutProps) {
-  const { appName, logoUrl, primaryColor, supportEmail } = emailConfig;
-
-  return (
-    <Html>
-      <Head />
-      <Preview>{preview}</Preview>
-      <Body style={main}>
-        <Container style={container}>
-          <Section style={logoSection}>
-            {logoUrl ? (
-              <Img src={logoUrl} width="48" height="48" alt={appName} />
-            ) : (
-              <Text style={{ ...logoText, color: primaryColor }}>
-                {appName}
-              </Text>
-            )}
-          </Section>
-
-          <Section style={contentSection}>
-            <Heading style={h1}>{heading}</Heading>
-            {children}
-          </Section>
-
-          <Hr style={hr} />
-
-          <Section style={footer}>
-            {showFooterLinks && (
-              <Text style={footerLinks}>
-                <Link href={`mailto:${supportEmail}`} style={footerLink}>
-                  Contact Support
-                </Link>
-              </Text>
-            )}
-            <Text style={footerText}>
-              © {new Date().getFullYear()} {appName}. All rights reserved.
-            </Text>
-            <Text style={footerMuted}>
-              If you didn't expect this email, you can safely ignore it.
-            </Text>
-          </Section>
-        </Container>
-      </Body>
-    </Html>
-  );
-}
-
-const main: React.CSSProperties = {
-  backgroundColor: '#f8fafc',
-  fontFamily:
-    '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Ubuntu, sans-serif',
-  padding: '40px 0',
-};
-
-const container: React.CSSProperties = {
-  backgroundColor: '#ffffff',
-  margin: '0 auto',
-  maxWidth: '560px',
-  borderRadius: '12px',
-  border: '1px solid #e2e8f0',
-  overflow: 'hidden',
-};
-
-const logoSection: React.CSSProperties = {
-  padding: '32px 40px 24px',
-  textAlign: 'center',
-};
-
-const logoText: React.CSSProperties = {
-  fontSize: '24px',
-  fontWeight: '700',
-  margin: '0',
-  letterSpacing: '-0.5px',
-};
-
-const contentSection: React.CSSProperties = {
-  padding: '0 40px 32px',
-};
-
-const h1: React.CSSProperties = {
-  color: '#0f172a',
-  fontSize: '24px',
-  fontWeight: '600',
-  lineHeight: '32px',
-  margin: '0 0 24px',
-  letterSpacing: '-0.25px',
-};
-
-const hr: React.CSSProperties = {
-  borderColor: '#e2e8f0',
-  borderTop: 'none',
-  margin: '0',
-};
-
-const footer: React.CSSProperties = {
-  padding: '24px 40px',
-  backgroundColor: '#f8fafc',
-};
-
-const footerLinks: React.CSSProperties = {
-  textAlign: 'center',
-  margin: '0 0 16px',
-};
-
-const footerLink: React.CSSProperties = {
-  color: '#64748b',
-  fontSize: '13px',
-  textDecoration: 'underline',
-};
-
-const footerText: React.CSSProperties = {
-  color: '#64748b',
-  fontSize: '13px',
-  lineHeight: '20px',
-  textAlign: 'center',
-  margin: '0 0 8px',
-};
-
-const footerMuted: React.CSSProperties = {
-  color: '#94a3b8',
-  fontSize: '12px',
-  lineHeight: '18px',
-  textAlign: 'center',
-  margin: '0',
-};

package/template/apps/api/emails/config.ts

@@ -1,22 +0,0 @@
-/**
- * Email template configuration.
- *
- * IMPORTANT: Update these values before deploying to production.
- * The logo must be hosted at a publicly accessible URL.
- */
-
-export interface EmailConfig {
-  appName: string;
-  websiteUrl: string;
-  supportEmail: string;
-  primaryColor: string;
-  logoUrl: string | undefined;
-}
-
-export const emailConfig: EmailConfig = {
-  appName: 'Your App',
-  websiteUrl: 'https://yourapp.com',
-  supportEmail: 'support@yourapp.com',
-  primaryColor: '#2563eb',
-  logoUrl: undefined,
-};