Skip to content →
DOC 02 // MANUAL

Sovereign Edge Architecture

100% static compilation, zero runtime Workers overhead, and Cloudflare Pages free tier deployment topology.

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.