Skip to content

Diagram Library

This library centralises every approved diagram for the platform. Diagrams must render client-side to preserve our lightweight toolchain and Cloudflare Pages compatibility.

  • System Context — Macro view of users, boundaries, and platform components.
  • Deployment Topology — Local Docker workflow mapped to future Cloudflare hosting.
  • Security Boundaries — Trust zones and zero-trust controls.
  • Data Flow — Content and governance flows across marketing, documentation, and future services.
  • Mermaid diagrams should remain under 200 nodes and favour clarity over artistic flair.
  • D2 diagrams should label dashed nodes or connectors as future when not yet implemented.
  • Refresh affected diagrams when ADRs change; reference ADR identifiers in captions where relevant.