Connections

Connections are visual links between resources on your project canvas. They allow you to document how the components of your system relate to each other, making your infrastructure topology easy to understand at a glance.

Connections are persisted with your project and load automatically whenever you open the canvas. They are purely a documentation and visualization tool — they do not provision networking or change runtime communication between resources.

Creating a Connection

To create a Connection between two resources:

1. Click the Edit Mode button (pencil icon) in the bottom-right corner of the canvas
2. Drag from any handle on one resource node to a handle on another resource node
3. The connection is saved automatically

When edit mode is active, small handles appear on all four sides of each resource node (top, right, bottom, left). These indicate the points from which connections can originate or terminate.

Editing a Connection

To modify or remove an existing connection:

1. Ensure Edit Mode is active
2. Right-click on the connection line
3. A context menu appears with the following options:
   • Line Type — Change the visual style of the connection
   • Delete Connection — Remove the connection entirely

Connection Types

Connections support three visual styles that affect how the line is drawn between resources:

The connection type is purely cosmetic and does not affect any runtime behavior. Choose whichever style makes your architecture diagram clearest.

Handle Positions

Each connection remembers which side of each resource node it connects from and to. The four available positions are:

• Top
• Right
• Bottom
• Left

This ensures your canvas layout is preserved exactly as you arranged it, even after reloading.

Constraints

• A resource cannot be connected to itself
• Only one connection is allowed between any two resources in the same direction
• Connections are scoped to a single project — you cannot connect resources across different projects

Canvas Behavior

• Handles only appear when edit mode is enabled
• Connections load alongside resources when a project opens
• A green dot animation runs along each connection to indicate a healthy network connection
• The edit mode toggle and connection tools are located in the bottom-right control panel of the canvas