A map of the engineering setup. The detailed docs live in the main repo under docs/; this page tells you where to look.
Stack
| Layer | What we use |
|---|---|
| Database | Supabase (Postgres, Auth, row-level security) |
| Backend | Python and FastAPI, hosted on Railway |
| AI | Anthropic Claude |
| Frontend | TanStack Start, run with Bun |
Shipping
- All work lands through a pull request. Deploys happen on merge.
- Database changes are SQL migrations in
supabase/migrations/. A migration must be applied to the database when its PR merges, not later. - Work is tracked in Linear, in the Cellpath MVP: North Star project.
Where the docs are
docs/README.mdin the main repo: the map of all engineering docsdocs/substrate/: how to add a new domain moduledocs/decisions/: architecture decision records (ADRs)