solo.engineering

The complete platform for one person engineering teams.

This repository is a pnpm workspace monorepo.

Layout

.
├── apps/
│   ├── landing/    # Marketing site (Next.js 15 + React 19)
│   └── app/        # Product app — UI + API routes + Supabase (Next.js 15)
├── package.json
├── pnpm-workspace.yaml
└── tsconfig.base.json

The product (web UI), backend (API), and database (Supabase) all live inside a single Next.js codebase at apps/app:

• UI: apps/app/src/app/
• API route handlers: apps/app/src/app/api/
• Supabase project: apps/app/supabase/
  • Declarative schemas (source of truth): apps/app/supabase/schemas/
  • Generated migrations: apps/app/supabase/migrations/
• Supabase clients: apps/app/src/lib/supabase/

Requirements

• Node.js >= 20
• pnpm >= 10 (corepack enable or npm i -g pnpm)
• Docker (for local Supabase via apps/app)

Getting started

pnpm install

Run everything in parallel

pnpm dev

Run a single app

pnpm dev:landing   # http://localhost:3000
pnpm dev:app       # http://localhost:3001  (UI + /api/* routes)
pnpm db:start      # Supabase: 54321 (api), 54322 (db), 54323 (studio)

Build / lint / test

pnpm build
pnpm lint
pnpm test

Apps

Package	Stack	Default port
@app/landing	Next.js 15, React 19, TS	3000
@app/app	Next.js 15 (UI + Route Handlers) + Supabase (Postgres)	3001 / 5432x

See each app's README for details.