Baseleg Docs

ADR-001: Runtime and hosting

Date: 2026-04-28 Status: Accepted

Context

Baseleg needs a lightweight hosting model suited to a small team, with a Cloudflare-friendly runtime for the product app and a simple way to publish documentation.

Decision

  • The product app (apps/web) will target the Cloudflare runtime.
  • Documentation (apps/docs) will be published to GitHub Pages as a static site.

Consequences

  • Runtime-specific bindings (e.g. D1) are isolated to infrastructure and app wiring.
  • Docs publishing is decoupled from production deployments.

Alternatives considered

  • Single deployable for both app and docs (tighter coupling)
  • Other hosts/runtimes (would reduce alignment with D1/Workers)