> For the complete documentation index, see [llms.txt](https://docs.protoboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.protoboard.xyz/editor/canvas-basics.md).

# Editor tour and canvas basics

Find your way around the editor: panels, canvas modes, the toolbar, placing parts, connecting them and context menus

## Goal

Find your way around the board editor: what each panel is for, how to move around the canvas, and how to place, connect and organize parts.

***

## The editor at a glance

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-6231d48019be2d375d471619ad4919e2ca7cf418%2Feditor-overview-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-36c2d6da726c875719bfc7cb6a2f8829d99acba4%2Feditor-overview-light.png?alt=media" alt="The board editor: the header with the Project menu, board name, status pill, share and theme buttons; the left rail with ProtoBot, Board Identity, Parts Bin, Board Review and Bill of Materials; the canvas in the middle with its toolbar; and the Inspector on the right"></picture><figcaption><p>The board editor.</p></figcaption></figure>

| Area              | What it holds                                                                                                                                                     |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Header**        | The **Project menu** (Protoboard logo), the board name and status pill, the share button, the theme button and **More options**                                   |
| **Left rail**     | **ProtoBot**, **Board Identity**, **Parts Bin**, **Board Review** and **Bill of Materials**. At the bottom: Website, Documentation, Feedback & Issues and Discord |
| **Canvas**        | Your board. The floating toolbar adds parts, notes and groups, takes screenshots and controls the view                                                            |
| **Inspector**     | Details of whatever is selected, or the object tree when nothing is                                                                                               |
| **Shortcuts bar** | Bottom left of the canvas: hints for what you can do right now. Click it for the full list                                                                        |

See the [Menus reference](https://docs.protoboard.xyz/editor/menus-reference.md) for every menu item.

***

## The workspace

The canvas is an **infinite 2D workspace** with a dot grid background. You can pan and zoom freely to work at any scale. Parts snap to the grid automatically, keeping your layout tidy.

{% columns %}
{% column %}

### Navigation controls

* **Pan**: Hold **Space** and drag, drag with the right or middle mouse button, or switch to **Pan mode**
* **Pan with the keyboard**: Focus the canvas (press Tab when the board opens and choose **Skip to canvas**), then use the arrow keys. Hold **Shift** to pan farther
* **Zoom in/out**: Scroll wheel or pinch, or use the **Zoom in** and **Zoom out** buttons in the toolbar
* **Zoom to fit**: Use **Frame all parts** to see your entire board at once, or **Frame selection** to focus on what you selected
* **MiniMap**: Use **Show minimap** for a small overview of your board, useful for orientation on large designs
  {% endcolumn %}

{% column %}

### Canvas modes

| Mode       | Behavior                                  | Activate                                                      |
| ---------- | ----------------------------------------- | ------------------------------------------------------------- |
| **Select** | Select and move parts                     | Default mode, or the **Select mode** toolbar button           |
| **Pan**    | Pan the canvas without selecting anything | The **Pan mode** toolbar button, or hold Space while dragging |

On phone-sized screens the canvas opens locked in pan-only mode so a touch cannot move parts by accident. Use the lock button in the dock to allow editing.
{% endcolumn %}
{% endcolumns %}

***

## Placing parts

<figure><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-1dc596a9ebeed6c77b6069cd1881080dba13cf4d%2Fug-open-parts-bin.gif?alt=media" alt="The cuboid icon in the left activity bar is selected and the Parts Bin panel opens beside a board with two parts joined by a harness"><figcaption><p>Selecting the cuboid icon opens the Parts Bin.</p></figcaption></figure>

{% stepper %}
{% step %}

### Open the Parts Bin

Click **Parts Bin** (the cuboid icon) in the left rail. The panel is titled **Manage Parts**.
{% endstep %}

{% step %}

### Find your part

Search for a part by name or keyword. Protoboard uses AI-powered semantic search, so describing what you need (e.g., "temperature sensor" or "brushless motor driver") works well.
{% endstep %}

{% step %}

### Add it to the board

Click **Add** on the part card. The part lands in free space near the middle of the canvas. You can also drag a card onto the canvas to place it exactly: an orange preview follows your cursor until you release.

**Keyboard alternative:** Tab to the part card's **Add** button and press Enter. The part is added to the board and appears in the Inspector's object tree.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Parts snap to the grid when placed. You can reposition them at any time by clicking and dragging.
{% endhint %}

***

## Creating connections (harnesses)

Connections between parts are called **harnesses**. Each harness represents the logical link between two parts and can contain multiple interface links and wire-level function links.

{% stepper %}
{% step %}

### Hover near a part edge

Move your cursor near the edge of a placed part. A **dynamic handle** appears, indicating a connection point.
{% endstep %}

{% step %}

### Drag to another part

Click the handle and drag a line to another part on the canvas. When you release over a valid target, a **harness** is created between the two parts and the Inspector opens for it.
{% endstep %}

{% step %}

### Configure the harness

Select the harness to open the **Inspector** panel, where you can set up interface links, function links, and resource allocation. See [Harnesses and function links](https://docs.protoboard.xyz/editor/harnesses-and-function-links.md) for details.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
After a connection is made, **static handles** persist on the connected parts so you can easily see and manage your harnesses.
{% endhint %}

{% hint style="info" %}
**Keyboard alternative:** Open the first part from the Inspector's object tree, activate **Create harness**, choose the destination part, and activate **Create**. See [Accessibility](https://docs.protoboard.xyz/help/accessibility.md) for the full keyboard workflow.
{% endhint %}

***

## Context menu actions

Right-click a part, harness, group or empty canvas, or press **Shift+F10** with the canvas focused. Right-clicking selects what you clicked. The menu changes with the selection:

{% tabs %}
{% tab title="Parts selected" %}

* **Copy**: copy the selected parts
* **Duplicate**: make an offset copy at once
* **Rename**: rename the part (one part selected)
* **Auto-route harnesses**: point the part's harness handles at the parts they connect to
* **Tidy handles**: spread one part's handles out evenly
* **Arrange selected**: lay out two or more parts with **Tidy**, **Auto** or **Grid**
* **Group**: wrap the selected parts and notes in a group
* **Delete**: remove the selection, like the Delete key
  {% endtab %}

{% tab title="Harness selected" %}

* **Auto-route this harness**: tidy the harness's handles
* **Move source handle** / **Move target handle**: move a handle to the Top, Right, Bottom or Left of its part
* **Delete**: remove the harness
  {% endtab %}

{% tab title="Group selected" %}

* **Ungroup**: remove the group and keep its contents
  {% endtab %}

{% tab title="Empty canvas" %}

* **Paste**: paste what you copied
  {% endtab %}
  {% endtabs %}

When you're viewing a board without editing control, the menu only offers actions that don't change the board.

***

## Groups and notes

Use **Add group** in the toolbar to wrap selected parts in a coloured, labelled frame, and **Add note** to drop a sticky note in free space and link it to a part. See [Groups and notes](https://docs.protoboard.xyz/editor/groups-and-notes.md).

***

## Undo, redo, copy, and paste

Protoboard supports full undo/redo for all operations:

| Action | Windows / Linux    | macOS              |
| ------ | ------------------ | ------------------ |
| Undo   | Ctrl+Z             | Cmd+Z              |
| Redo   | Ctrl+Shift+Z       | Cmd+Shift+Z        |
| Copy   | Ctrl+C             | Cmd+C              |
| Paste  | Ctrl+V             | Cmd+V              |
| Delete | Delete / Backspace | Delete / Backspace |

{% hint style="info" %}
Duplicated and pasted parts are placed with a slight offset so they do not stack directly on top of the originals.
{% endhint %}

***

## Themes and high contrast

Protoboard follows your system's light or dark setting. Use the theme button in the top bar to switch between **light mode** and **dark mode**; your choice is remembered in this browser.

For stronger text, border, and focus contrast, press Tab once on any page and activate **High contrast mode** in the Accessibility shortcuts bar, or open **More options** (the three-dot button next to the theme button) and select **High contrast mode**. It works with both themes, is remembered in this browser, and turns on automatically when your operating system's increased contrast setting is on. See [Accessibility](https://docs.protoboard.xyz/help/accessibility.md).

***

## Keyboard and screen reader access

The canvas is a visual diagram, so Protoboard also presents the board as a list. Open the **Inspector** to browse every part, harness, group, and annotation in the **object tree**, and expand **Board text summary** for a text description of the whole board. You can create harnesses, notes, and groups, edit positions, and delete objects from the Inspector without a mouse. See [Accessibility](https://docs.protoboard.xyz/help/accessibility.md).

***

## Common failures

<details>

<summary>I cannot connect two parts; no handle appears</summary>

Make sure you are in **Select** mode (not Pan mode). Hover slowly near the edge of the part node. The dynamic handle only appears when your cursor is close to the node boundary.

</details>

<details>

<summary>My board is too zoomed in and I cannot find my parts</summary>

Use **Frame all parts** in the canvas toolbar to zoom out and center on all placed parts. You can also use the **MiniMap** to navigate to a specific area, or open a part from the Inspector's object tree to frame it.

</details>

<details>

<summary>Parts are not aligning neatly</summary>

Parts snap to the grid by default. If things look messy, select the parts you want to organize, right-click, and choose **Arrange selected**.

</details>

***

## Related pages

* [Parts Bin](https://docs.protoboard.xyz/editor/parts-bin.md): find and add parts
* [Harnesses and function links](https://docs.protoboard.xyz/editor/harnesses-and-function-links.md): configure harnesses after connecting parts
* [Keyboard Shortcuts](https://docs.protoboard.xyz/editor/keyboard-shortcuts.md): speed up canvas work with shortcuts
* [Accessibility](https://docs.protoboard.xyz/help/accessibility.md): keyboard-only workflows, high contrast mode, and screen reader notes
* [Menus reference](https://docs.protoboard.xyz/editor/menus-reference.md): every menu in the editor
