Quick Start

Prerequisites

• Bun >= 1.1 (package manager + runtime)
• Docker (for PostgreSQL and Redis)
• Node.js >= 22

Setup

1. Install dependencies

bun install

2. Start infrastructure

docker compose up -d

This starts:

• PostgreSQL 16 on port 5433 (user: pinteach, password: pinteach)
• Redis on port 6379

3. Run database migrations

bun run db:migrate

4. Seed development data

bun run db:seed

5. Start the dev servers

bun run dev

This starts all apps via Turborepo:

• API: http://localhost:3001
• Frontend: http://localhost:3737 (proxies /api to :3001)

Start individual apps

bun run dev --filter=api    # API only
bun run dev --filter=web    # Frontend only

Dev Login

For development, use the quick login endpoint:

GET http://localhost:3001/api/auth/dev-login/:teacherId

The seed data includes teacher Maria Garcia with ID 00000000-0000-4000-a000-000000000001.

Useful Commands

Command	Purpose
bun run typecheck	TypeScript check all 5 packages
bun run lint	Lint + format check (Biome)
bun run build	Build all packages
bun run db:studio	Open Drizzle Studio
bun run db:generate	Generate Drizzle migrations

Environment Variables

Create .env files in apps/api/:

DATABASE_URL=postgresql://pinteach:pinteach@localhost:5433/pinteach
REDIS_URL=redis://localhost:6379
APP_URL=http://localhost:3737
PORT=3001
SESSION_SECRET=your-secret-min-32-chars
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...
STRIPE_SECRET_KEY=...
RESEND_API_KEY=...

See the full environment variables list for all options.