Architecture diagrams
What it is
Which parts a system is made of and how they connect, with built-in cloud, database, disk and server icons.
When to use it
Deployment architecture, what a system is composed of.
How to write it
Pamphlet's own syntax — declarations first, relationships second; all seventeen kinds share this skeleton:
This syntax does not render on GitHub. If you need it to, write the same diagram as a Mermaid fence instead.
What comes out
Drawn to SVG at compile time and inlined into the output, so the reader downloads no drawing library and makes no network request. Colours follow the theme; scroll to zoom, drag to pan, double-click to reset.
Traps
- The block names are fixed:
services:andlinks: - A service line is
id = icon "label"; the icon name goes straight to Mermaid —cloud/database/disk/server/internet, defaulting toserver - Write a link as
a -- b; which edge it leaves from is chosen for you (alwaysRtoL) - Groups (
group) are not available here — use a Mermaid fence for those