Architecture Diagrams

Excalidraw diagrams for SecurityV0 architecture documentation.

Conventions

• Always commit both .excalidraw (source) and .png (rendered) — both are required
• .excalidraw is the source of truth; regenerate PNG from it if needed:

  cd /home/agent/.claude/skills/excalidraw-diagram/references
  uv run python render_excalidraw.py <path-to-file.excalidraw>

• Name the PNG identically to the .excalidraw file (extension only differs): sv0-system-overview.excalidraw → sv0-system-overview.svg
• Reference PNGs in markdown: ![Description](diagrams/filename.png)
• .excalidraw files are excluded by Docusaurus config; PNGs render natively in docs
• Dark mode: Excalidraw PNGs have white backgrounds. The Docusaurus site auto-inverts them in dark mode via CSS (filter: invert(1) hue-rotate(180deg)). When adding a new diagram, add a matching CSS selector in docusaurus-site/src/css/custom.css:

  [data-theme='dark'] img[src*="your-new-diagram-name"],

Diagrams

File	Description	Doc Reference
sv0-system-overview	High-level system components and data flow	architecture/00-overview.md