Scripts

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

Development

Start Development Server

bun run 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

bun run dev --filter=web    # Only web app
bun run dev --filter=docs   # Only docs

Building

Build All Apps

bun run build

Runs:

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

Build Specific App

bun run build --filter=web
bun run build --filter=docs

Build Without Migrations

bun run build:only

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

Production

Start Production Server

bun run start

Starts the production server for all apps.

Database

Run Migrations

bun run db:migrate

Applies pending database migrations. Safe to run multiple times.

Push Schema (Development)

bun run db:push

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

Generate Migration

bun run db:generate

Generates a new migration file from schema changes.

Open Database Studio

bun run db:studio

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

Code Quality

Type Checking

bun run tsc

Runs TypeScript type checker across all apps.

Linting

bun run lint

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

Formatting

bun run format        # Format all files
bun run format:check  # Check without formatting

Formats code with oxfmt (Rust-based formatter).

CSS Linting

bun run stylelint

Runs Stylelint on CSS files.

Testing

Run All Tests

bun test

Runs the test suite.

Load Testing

# Start the app first
docker compose up -d
bun run dev

# In another terminal
bun run 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
bun run 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