DOC 02 // MANUAL
Sovereign Edge Architecture
100% static compilation, zero runtime Workers overhead, and Cloudflare Pages free tier deployment topology.
// On This Page
Sovereign Edge Architecture
BOB-Astro is engineered on a strict Zero-Workers Static Architecture to unlock maximum performance and zero operational costs on Cloudflare Pages free tier.
1. Why Zero Workers?
Standard serverless edge functions introduce:
- Cold-start latency (15ms - 250ms).
- Runtime CPU limits and execution cost ceilings.
- Concurrent invocation throttling on free tiers.
By enforcing output: 'static' in astro.config.mjs and prohibiting functions/ directories, BOB-Astro guarantees:
- 0ms Server Execution Time: Static byte streams served directly from Cloudflare’s 330+ global edge nodes.
- Unlimited Free Bandwidth: Full advantage of Cloudflare Pages free tier tiering.
- Support for up to 20,000 Pre-rendered Pages: Sufficient for large content platforms, documentation hubs, and agency portfolios without entering paid tiers.
2. Edge Purity Verification Gate
Our custom audit suite (scripts/audit-cloudflare-static.js) runs 10 deterministic gates:
| Gate | Verification Check | Requirement |
|---|---|---|
| 01 | Static Root Output | dist/index.html exists and is non-empty |
| 02 | Zero Server Workers | No functions/ directory or worker adapters |
| 03 | Free Quota Headroom | Page count $\le 20,000$ |
| 04 | Zero Hardcoded Hex | No #hex color literals in src/components/ |
| 05 | Wrangler Target | wrangler.jsonc targets ./dist directory |
| 06 | Edge Headers | HSTS, CSP, and immutable CDN caching |
| 07 | Content Schema | Astro 7 Content Layer collections validated with Zod |
| 08 | Craft Primitives | All craft primitives verified in repository |
| 09 | OKLCH Multi-Palette | 6 mathematical OKLCH presets defined |
| 10 | Decoupled Toolchain | CLI runner isolated in bin/abc-astro |
3. Deployment Protocol
Deploying to Cloudflare Pages requires a single command:
npm run deploy
This runs astro build followed by npx wrangler pages deploy dist, deploying your pure pre-rendered site in seconds.