Skip to content
Internal Engineering Docs

ADR-001: Edge-native Architecture

Status: Accepted

Context

The platform targets Asia-Pacific markets where latency to a single-region origin server can exceed 200ms. We needed a globally distributed compute model with predictable cold-start behaviour.

Decision

All Workers (core-platform, edge-api-gateway, infra-email) are deployed as Cloudflare Workers. There is no origin server.

Consequences

  • Positive: Sub-50ms cold starts, 300+ global PoPs, no infrastructure management.
  • Positive: Data residency enforcement is a Cloudflare-native capability (D1, KV).
  • Negative: Cloudflare Workers runtime constraints (no native Node.js APIs).
  • Mitigation: Use Web-standard APIs only; wrap Node-specific utilities behind polyfills where needed.