# Draw your map

Use the canvas to describe the services, boundaries, and relationships that help
you reason about your infrastructure. The map remains useful before you connect
any live checks.

## Add and edit nodes

Click a palette item to place it near the center of the view, or drag it onto the
canvas. Double-click empty space to create the last-used node kind. Select a
node and drag its resize handles to change its size.

Double-click a title to rename it inline. Double-click the card body, or select
the node and choose **Inspector**, to edit its details. Choose **Save details**
to apply staged changes.

Kinds such as **Application**, **Database**, and **Pod** provide a visual
vocabulary and relevant endpoint fields. They do not install a service, discover
resources, or automatically enable a check. Add checks explicitly in the Inspector.

## Connect nodes

Click a port dot on the source node, then click the destination node. Press
Escape to cancel an unfinished connection. Select the edge to choose its kind
in the Inspector; double-click the edge to edit its label.

Edges describe directed relationships. Their kinds change the drawing style;
they do not configure networking or measure traffic. Use labels to make intent
clear, such as `5432`, `HTTPS`, or `depends on`.

## Add context

- **Notes:** use a Note card for text that should stay visible. Other nodes also
  have a Notes field in the Inspector.
- **Add-ons:** attach RAM, disk, GPU, IP, certificate, or other resource labels.
  These are manually maintained facts, not collected measurements.
- **Page:** enter an absolute HTTP(S) URL and save the details to embed a page in
  a sandboxed card. A website may refuse to be embedded. See
  [troubleshooting](troubleshooting.md#an-embedded-page-is-blank).

An embedded Page loads in the viewing app or browser. It is not fetched through
the Team daemon, so each viewer needs network access to it. PDF export includes
the Page title and URL rather than a screenshot of its content.

## Organize with groups

Use **Box**, **Host**, or a cloud/network boundary to group nodes. Creating a
group around sibling nodes adopts them; dropping a node fully inside a group
assigns it to that group. Moving a group carries its descendants.

**Tree** shows the same membership and selection in a compact hierarchy. It does
not infer network dependencies from edges. See [groups and Tree view](hierarchy.md).

## Navigate and undo

Drag empty space or scroll to pan. Pinch or Ctrl-scroll to zoom at the cursor;
the toolbar also has **−**, **+**, and **Fit**. The **g** shortcut toggles grid
snapping; **n** reverses scroll direction.

Shift-click to change a multi-selection. Delete or Backspace removes the
selection. Undo and redo cover visual edits, not executed commands or deleted
operational definitions. See [keyboard shortcuts](shortcuts.md).

Team viewers can navigate, inspect, and export but cannot edit the shared map.
On a small screen, the **⋯** menu holds controls such as PDF export and theme.
