Monorepo with Next.js frontend + FastAPI backend.

apps/
  web/        # main Next.js app (Bun)
  marketing/  # landing page (Next.js / Bun)
  api/        # FastAPI (uv)
packages/
  shared/     # shared TypeScript types

• Bun >= 1.3
• uv >= 0.4
• Python >= 3.12

# install all JS dependencies
bun install

# install Python dependencies
cd apps/api && uv sync && cd ../..

# start the main app       (http://localhost:3000)
bun run dev

# start the marketing page (http://localhost:3001)
bun run marketing:dev

# start the API            (http://localhost:8000)
bun run api:dev

Open separate terminals for each service.

• apps/web/.env.local — main app env vars
• apps/marketing/.env.local — landing page env vars
• apps/api/.env — backend env vars

After seeding the database, you can use the following default credentials to log in and test different role-based views: