Diagram Editor

The Diagram Editor is where you build your architecture visually. Each diagram view has a full-featured canvas with a toolbar, properties sidebar, and multiple tabs for different perspectives.

View Tabs

When you open a diagram view, you see action buttons that take you to different perspectives:

Each tab provides a specialized interface for a different aspect of your architecture.

Editor Canvas

The Editor tab is the primary canvas where you build diagrams:

Toolbar

The canvas toolbar at the top provides actions for working with the diagram:

• Add to View --- Open the system panel to select existing systems to add to the canvas
• Zoom controls --- Zoom in, zoom out, and fit view
• Undo / Redo --- Step through canvas changes
• Auto-layout --- Automatically arrange systems on the canvas using ELK-based layout algorithms. Supports grid and radial layout modes for different visualization needs.

System Panel

Click Add to View to open the system panel on the left. This panel shows all project systems that can be placed on the canvas. Search and filter systems, then drag them onto the canvas or click to add them.

Properties Sidebar

Click any system or connection on the canvas to open its properties in a sidebar panel. From here you can:

• View and edit the element's name, description, technology, and type
• Change the parent system for hierarchy nesting
• Navigate to the element's detail page
• Delete the element

Canvas Interactions

• Drag systems to reposition them on the canvas
• Click a system to select it and open properties
• Shift-click to multi-select systems for group operations
• Drag from a handle on a system to create a connection to another system
• Scroll to zoom in and out
• Click and drag on empty space to pan the canvas

Selective Expansion

Systems with children show expand/collapse controls in the bottom-right corner of the node:

• Expand all --- Click the expand button to show all child systems on the canvas
• Collapse all --- Click the collapse button (minus icon) to hide all expanded children
• Children Picker --- Click the picker button to open a popover where you can selectively choose which children to expand. Check the children you want visible on the canvas and uncheck those you want to hide. This gives you fine-grained control over what's displayed without showing the entire hierarchy.

The children picker pre-selects any children already visible on the canvas, so you can quickly add or remove individual children.

Edge Routing

Connections between systems use intelligent edge routing with magic positioning that:

• Automatically calculates optimal anchor points based on relative node positions
• Avoids overlapping with other system nodes
• Updates dynamically when you move systems
• Displays connection labels along the edge

View Statistics

Above the diagram card on the Views page, you can see summary statistics:

Creating a New View

From the Views page in your project sidebar, click Create Diagram to create a new view. Provide a name for the view and it will be added to your project.

Next Steps