Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

ADR-001: Build on sqlx rather than a custom driver

Date: 2026-08-13
Status: Accepted

Decision: sqlx provides connection pooling, the wire protocols, TLS, and type encoding. We generate code that calls it.

Why: writing a Postgres wire-protocol implementation is a multi-month project with a large security surface and no differentiation. Every hour spent there is an hour not spent on the schema DSL, diffing, and relation loading — which is where the actual product is.

Cost: we inherit sqlx's release cadence and any breaking changes. Mitigated by an exact version pin in the runtime crate.