Connecting Nodes
A connection between two nodes (an edge) represents a real link — a network cable, a data path, a dependency. This is the “plumbing” of a diagram.
Drawing a connection
Section titled “Drawing a connection”Every device has small connection handles — a dot on its top and bottom edges, always visible, and one on each side that appears when you hover over the device (or while you’re dragging a connection). To connect two devices:
- Hover over a device until you see its handles.
- Click and drag from one of its handles to a handle on another device.
- Release — a line now connects the two.
Any handle can be either end of a connection, so pick whichever sides make the line read cleanly: top-to-bottom for a hierarchy, side-to-side for peers. You can draw as many connections as you like between any two devices; a device can’t be connected to itself.
Labelling a connection
Section titled “Labelling a connection”Select a connection and the toolbar at the top-right of the canvas offers three fields:
- Label — free text, e.g. “uplink”, “replication”, “VLAN 20 trunk”.
- Protocol and Port — e.g.
HTTPSand443.
Whatever you fill in is drawn on the line itself (replication · PostgreSQL/5432) and listed in the generated documentation’s connections table.
Automatic edge coloring
Section titled “Automatic edge coloring”Schema colors connections automatically based on what they cross, so you can spot boundary crossings at a glance without styling anything yourself:
- Blue — both ends of the connection are in the same zone or segment (or both are outside any container).
- Orange — the connection crosses from one container into a different one, or from a container out to open canvas.
- Gray — neither end belongs to a container at all.
You can always override the automatic color yourself — see Colors.
Selecting and deleting a connection
Section titled “Selecting and deleting a connection”Click directly on a connection’s line to select it (its color toolbar appears, covered in Edge Styles). With it selected, press Delete or use the ribbon’s Delete button to remove it. Deleting a node also removes any connections attached to it.
Where to go next
Section titled “Where to go next”- Style the connection’s arrow direction and line shape
- Add an animated data-flow indicator to show traffic direction
- Set up a compliance rule that checks what a node is (or isn’t) connected to