Development

Developer docs

Local setup and implemented interfaces for developers building Provenience.

Run the local Site database

Start the local Site backing services and verify them through the Site health endpoint.

Platform runbook

The production runbook for any Provenience Site, from opening its hosting to answering each alert, using placeholders only.

Open a Site

Create a Site's Supabase project, Twilio number, Railway project, and GitHub Environment in order, and provision its Deposit identities.

Set up the Site web app

Create a Site's Vercel project, configure Supabase sign-in, provision administrators, and run the first checks after a first deploy.

Deploy and roll back

How code and migrations reach a Site in order, how to deploy and roll back the backend and web app, and what each reverse script loses or refuses.

Turn Extract on

Seed a Site's typology and switch its worker from Capture only to Extract, in the go-live order.

Turn MCP on

Turn on the MCP connection for a Site in order, with a check for each step, and how to revoke and turn it off.

Rotate credentials

Each credential a Site uses, where it lives, and what changing it requires, including what breaks if a service keeps the old one.

Monitoring and alerts

What is watched on a Site, what each alert means, and the first thing to check when it fires.

Incident runbooks

Symptoms, checks, and actions for each failure a Site can have.