supatype

Supatype

Schema-first backend for PostgreSQL — TypeScript models, generated migrations, RLS, and a unified API gateway (supatype-server).

This monorepo ships @supatype/cli, @supatype/client, @supatype/react, Studio, storage, and realtime packages.

Documentation for users: GitHub Pages — local dev and self-host guides live there (#local-dev, #self-host).

---

Deployment modes (summary)

Mode	Command	Postgres	Everything else
Dev	supatype dev	Native (default) or Docker for Postgres only	Native engine + supatype-server binaries
Self-host	supatype self-host compose up	Docker (supatype/postgres:17-latest)	Docker Compose — images default to :latest on Docker Hub

---

Monorepo development

pnpm install
pnpm supatype init
pnpm supatype dev

Overrides: supatype.local.config.ts beside supatype.config.ts.

pnpm build
pnpm turbo run typecheck
pnpm --filter @supatype/cli test

---

Schema workflow

supatype diff
supatype push
supatype generate

---

Binary cache (dev)

supatype update
supatype cache list

Components download from https://releases.supatype.com.