Scripts

All scripts should be run from the repository root using Bun and Turborepo.

Development

Start Development Server

pnpm dev

Starts the Next.js development server with Turbopack for fast hot-reloading.

• Web app: http://localhost:3000
• Docs: http://localhost:3001

Filter by App

pnpm --filter web dev    # Only web app
pnpm --filter docs dev   # Only docs

Building

Build All Apps

pnpm build

Runs:

1. Database migrations (db:migrate)
2. Next.js production build

Build Specific App

pnpm --filter web build
pnpm --filter docs build

Build Without Migrations

pnpm build:only

Skips database migrations (useful for CI or when migrations already ran).

Production

Start Production Server

pnpm start

Starts the production server for all apps.

Database

Run Migrations

pnpm db:migrate

Applies pending database migrations. Safe to run multiple times.

Push Schema (Development)

pnpm db:push

Pushes schema changes directly to the database without creating migration files. Development only — use migrations for production.

Generate Migration

pnpm db:generate

Generates a new migration file from schema changes.

Open Database Studio

pnpm db:studio

Opens Drizzle Studio for visual database browsing and editing at http://localhost:4983

Code Quality

Type Checking

pnpm tsc

Runs TypeScript type checker across all apps.

Linting

pnpm lint

Runs ESLint on all apps. Auto-fixes where possible.

Formatting

pnpm format        # Format all files
pnpm format:check  # Check without formatting

Formats code with oxfmt (Rust-based formatter).

CSS Linting

pnpm stylelint

Runs Stylelint on CSS files.

Testing

Run All Tests

pnpm test

Runs the test suite.

Load Testing

# Start the app first
docker compose up -d
pnpm dev

# In another terminal
pnpm loadtest

Runs k6 load tests against the local development server.

Docker

Start Services

docker compose up -d

Starts PostgreSQL and Valkey containers.

View Logs

docker compose logs -f
docker compose logs -f db      # PostgreSQL only
docker compose logs -f valkey  # Valkey only

Stop Services

docker compose down

Reset Database

docker compose down -v  # Removes volumes
docker compose up -d
pnpm db:migrate

Turborepo

Turborepo caches task outputs for faster subsequent runs.

Clear Cache

bunx turbo run build --force

Forces a rebuild, ignoring cache.

View Task Graph

bunx turbo run build --graph

Visualizes task dependencies.

Script Summary

Next Steps

• Architecture — Understand the codebase
• Testing — Test strategy and guides
• Database Guide — Database operations