Quick Start

Prerequisites

• Node.js 20.x or later
• pnpm 9.x (corepack enable && corepack prepare pnpm@9 --activate)
• Access to the GitHub repository

Setup

1. Clone the repository

   git clone https://github.com/Fused-Gaming/brettjohnson.git
   cd brettjohnson

2. Install dependencies

   pnpm install

3. Configure environment variables

   cp .env.example .env.local

   Open .env.local and fill in the required values. At minimum for local dev:

   • NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY (from your Supabase project)
   • NEXT_PUBLIC_TURNSTILE_SITE_KEY — use the Cloudflare test key for local dev

   See the Environment Registry for the full variable list.

4. Start development servers

   All apps

   pnpm dev

   Starts all apps in parallel via Turborepo.

   Main site only

   pnpm dev:www

   Starts apps/www at http://localhost:3000

   API only

   pnpm dev:api

   Starts apps/api at http://localhost:3001

   Docs only

   pnpm --filter @brettjohnson/docs dev

   Starts this docs site at http://localhost:4321

Project Structure

brettjohnson-xyz/
├── apps/
│   ├── www/         # Main marketing site (brettjohnson.xyz)
│   ├── api/         # Backend API (api.brettjohnson.xyz)
│   ├── docs/        # This documentation site (docs.brettjohnson.xyz)
│   ├── book/        # Booking portal stub
│   ├── media/       # Media portal stub
│   ├── podcast/     # Podcast hub stub
│   └── training/    # Training portal stub
├── packages/        # Shared packages (UI, utilities, email templates)
├── docs/            # Source documentation files (Markdown)
├── .github/         # CI/CD workflows, issue templates
├── CLAUDE.md        # Brand blueprint and engineering spec
├── ROADMAP.md       # Milestone tracker
└── CONTRIBUTING.md  # Contribution guide

Available Commands

Command	Description
pnpm dev	Start all apps in development mode
pnpm build	Build all apps for production
pnpm lint	Run ESLint across all apps
pnpm type-check	Run TypeScript compiler checks
pnpm test	Run all unit tests
pnpm format	Format all files with Prettier

Branching

All feature work branches from develop. See Branching Strategy for the full GitFlow model.

git checkout develop
git pull origin develop
git checkout -b feature/my-feature

Next Steps

• Read the Architecture Overview to understand how the system is structured
• Review Contributing Guidelines for commit message format and PR process
• Check the Roadmap to see what’s in progress