Creating a connection
Click Add Connection in the toolbar to enter connection mode. The button highlights and a status message guides you through two clicks:
- Click the source component — it highlights, and the status reads "Select Target…"
- Click the target component — the connection is created and connection mode ends
A line immediately appears between the two components with a protocol label at its midpoint.
Editing properties
Click a connection line on the canvas to select it. The Side Panel opens with the following fields:
- From / To — the source and target components (read-only)
- Swap Direction — button to reverse source and target
- Bidirectional — checkbox to make the connection go both ways
- Protocol — the communication method, displayed as the midpoint label (e.g. "HTTP", "gRPC", "SQL", "WebSocket")
- Description — additional context about what flows through the connection
Changes are applied instantly. The protocol label updates on the canvas as you type.
Visual appearance
Connections are rendered as lines between the centers of two component blocks. An arrow indicates the direction of the connection, unless it is set to bidirectional.
The protocol label sits at the midpoint of the line. It rotates to follow the angle of the connection so it stays readable.
Connections follow their components automatically when you drag them to a new position — you never have to reconnect after moving a component.
Curvature
By default, connections are straight lines. When two components are linked by multiple connections, the lines overlap and become hard to read.
To fix this, drag a connection line to bend it. This adds curvature so each connection follows a distinct path between the same two components.
Deleting a connection
Two ways to delete a connection:
- Select it and press Delete
- Select it, open the Side Panel, and click the red Delete Connection button at the bottom
Connections are also removed automatically when one of their endpoints (source or target component) is deleted.