Where to click — one page
Eight steps from a blank project to a documented system you can hand over, each one answered in the interface: which screen, which pane, which gesture. It is the companion to The whole story on one page — that one says what to build, this one says where to click to build it — but it stands on its own, so it is the sheet to hand to someone opening the app for the first time.
Download it as a PNG or Print / Save as PDF with the buttons above the poster.
The one thing worth learning first
All three editors are the same screen with different furniture, so learning it once covers C4, deployment and F4:
- A header row — the model picker moves you between C4, D4 and F4 without leaving the project.
- A title bar — what this screen can do (Show me how, Reset layout, Connections, Settings).
- A left pane — your model. Every element lives here whether or not it is on the diagram you are looking at; the
+adds one, and a row's own+adds a child one level down. - A canvas — the picture. Drag to arrange, drag from a card's handle to connect, right-click for what you can do.
- A right pane — everything about whatever is selected. Nothing is edited anywhere else.
The wand, in three places
You do not have to build the diagram tree by hand. The wand derives it from the elements you have entered, and because it only ever adds, it is also how you keep the diagrams current — see the wand.
- The context diagram's row in the left tree carries a wand button ("Fill diagram structure") — one press builds the whole tree.
- Right-click the canvas for both wands: "Wand: this diagram" fills the diagram you are on from its subject; "Wand: all diagrams" does the whole tree.
- An empty diagram offers it too, as a Magic wand button on the overlay.
It never deletes, never repositions what you arranged, and never reorders — so run it again whenever you have added elements, and only the new ones turn up. A child you removed from a boundary stays removed.
The gestures
| Gesture | What it does |
|---|---|
| Drag from a card's handle | Draws a connection. Drop on empty space and you get the next element, already connected. |
| Double-click a card | Renames it, with the cursor already in the pane's Name field. |
| Right-click the canvas | Add a child, copy the diagram, run the wand, reset the layout. |
| Arrow keys | Nudge the selection one pixel; hold Shift for ten. |
| Drag a line | Bends it by hand. Drag its label to slide it along the line. |
| Drag a pane edge | Resizes it — the widths are remembered. |
Where next
- The whole story on one page — the same eight steps, as the model rather than the interface.
- Working in the three editors — the long-form version of the shell above.
- Your first diagram — a guided walk through steps 1 to 3.