ADR-009: Static Deployment via GitHub Pages
- Status: Accepted
- Date: 2026-08-12
Context & Problem Statement
Hosting dynamic documentation servers (e.g. Next.js SSR, custom backend APIs) requires maintaining running application containers, load balancers, and monitoring infrastructure. This expands the operational footprint and creates vulnerability to runtime exploitation.
Decision
Deploy the documentation website as a pure static build artifact via GitHub Pages (or any static object bucket/CDN):
- Production deployment runs
docusaurus buildvia GitHub Actions using OIDC tokens. - No Node.js process, Python server, or database runs in the serving path.
- Offline and local reading use the exact same static build directory (
build/).