Skip to main content

Diagrams

Visual architecture diagrams for the Qubital system. Every diagram is committed as both a .d2 source file and a rendered .svg so it is readable directly on GitHub without tooling.

Conventions​

  • Source format: D2 (.d2)
  • Rendered format: .svg (committed alongside the source)
  • Naming: <subject>.d2 + <subject>.svg — same name, different extension
  • Theme: shared Qubital D2 theme imported via ...@_theme

What belongs here​

Cross-system and cross-component diagrams: infrastructure topology, service interaction maps, data flow at the system level. Single-feature internals belong in the feature's page under ../../reference/backend/features/, not here.

What belongs in ../flows/ instead​

Sequence diagrams and step-by-step data flow narratives that are better expressed in prose or Mermaid than as a D2 topology diagram.