Roadmap & Phases

Phased delivery. Each phase must be stable and usable on its own. The companion apps (examples/todo/ and this docs site) exercise shipped features.

Phase 1 — Synchronous Core (v0.2.0 — complete)

All of M1.1–M1.4 + the v0.2 polish track (push retry, CLI-in-image, content-hashed immutable assets, 20 MiB cap) are done. See the Overview for the milestone table.

Phase 2 — Auth + realtime + declarative schema

• Cookie sessions + login/logout
• req.session + RLS bridge (SET LOCAL ROLE)
• CSRF double-submit for non-GET HTMX
• App-level realtime via SSE (reusing the internal ListenRouter)
• Declarative pg-web migrate create (Phase 2.5, native Rust diff)

Phase 3 — Async job queue

• pgweb.jobs + pg-web enqueue
• Worker pool in the BGW, retry, dead-letter, cron-like scheduling via settings

Phase 4 — Observability / dashboard

• In-browser dev dashboard at /_pgweb/admin
• Request log, slow query capture, Prometheus metrics, live log tail

Parking lot / explicit non-goals

• Managed-DB support (RDS/Cloud SQL/Supabase cannot load extensions)
• JavaScript build integration (Vite etc.) — stay HTML-first
• GraphQL, ORM, declarative routes (directory-as-route is invariant)

The full matrix and status live in docs/ROADMAP.md. Session notes are in docs/internal/sessions/.