Assets

Source files for diagrams, screenshots, and other media embedded in this knowledge base.

Conventions

• Prefer inline Mermaid in the page itself — it's diffable and Flowershow renders it natively.
• Use this folder only when a hand-drawn / exported diagram or a screenshot is unavoidable.
• Filename pattern: <topic>-<short-name>.<ext> (e.g. architecture-overview.png, admin-publishing-flow.excalidraw).
• Keep originals (Excalidraw, Figma exports, etc.) alongside the rendered image so they can be re-exported.

Folder layout

assets/
├── README.md
├── diagrams/                 # source files (excalidraw, drawio, figma exports)
└── screenshots/              # PNG/JPG screenshots used in guides

Embedding

In a markdown page:

![Architecture overview](../assets/diagrams/architecture-overview.png)

Use a relative path so it works both locally and in the published site.

---

Last reviewed: 2026-05-04