> 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/help/accessibility.md).

# Accessibility

Accessibility features in Protoboard: keyboard-only board editing, high contrast mode, reduced motion, screen reader support, and how to get help.

## Goal

Build and validate a board with the keyboard, a screen reader, high contrast, or browser zoom. This page covers the accessibility features in Protoboard, step-by-step keyboard workflows, and how to reach us when something gets in your way.

***

## Our commitment

Protoboard targets conformance with the **Web Content Accessibility Guidelines (WCAG) 2.1 Level AA** and the accessibility requirements of **EN 301 549**. Accessibility work is ongoing, and we improve it with every release.

An **Accessibility Conformance Report (ACR)**, based on the VPAT format, is available on request. Email <support@protoboard.ai> to request the current copy.

***

## Accessibility features at a glance

| Feature                         | What it does                                                                                                             | Where to find it                                                        |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| **Accessibility shortcuts bar** | **Skip to main content**, a **High contrast mode** switch, and **Accessibility help**                                    | The first Tab stop on every page                                        |
| **Skip links**                  | Jump straight to the canvas or the Inspector                                                                             | Press Tab at the start of the board editor                              |
| **Object tree**                 | Lists every part, harness, group, and annotation so you can browse and edit the board without a mouse                    | Inspector panel                                                         |
| **Board text summary**          | A text description of the whole board: parts, connections, groups, and positions                                         | Below the object tree in the Inspector                                  |
| **Keyboard canvas panning**     | Pan the canvas with arrow keys                                                                                           | Focus the canvas (Skip to canvas), then use arrow keys                  |
| **High contrast mode**          | Stronger text, surface, border, and focus contrast; turns on automatically with your system's increased contrast setting | Accessibility shortcuts bar, or the **More options** menu in the header |
| **Type-to-focus control**       | Choose whether typing on a page jumps to the chat box                                                                    | **More options** > **Typing moves focus to the chat box**               |
| **Light and dark themes**       | Follows your system setting until you choose one                                                                         | Theme button in the header                                              |
| **Reduced motion**              | Suppresses interface animations                                                                                          | Follows your operating system or browser setting                        |
| **In-app accessibility help**   | A short keyboard and screen reader guide inside Protoboard                                                               | **More options** > **Accessibility help**                               |

***

## Turn on high contrast mode

High contrast mode increases the contrast of text, surfaces, borders, and focus indicators. It keeps Protoboard's orange accent.

**Fastest way:** press **Tab** once on any Protoboard page. The **Accessibility shortcuts** bar appears; activate **High contrast mode**. The button is announced as pressed or not pressed.

**Automatic:** if your operating system's **Increase contrast** setting (or a forced colors mode such as Windows Contrast themes) is on, Protoboard turns on high contrast mode for you. Once you choose on or off yourself, your choice takes priority in this browser.

**From the menu:**

{% stepper %}
{% step %}

### Open More options

In the board editor or dashboard header, activate **More options** (the three-dot button next to the theme button). On a narrow screen in the board editor, open **More board actions** instead.
{% endstep %}

{% step %}

### Choose High contrast mode

Select **High contrast mode**. The menu item is a checkbox, so screen readers announce whether it is on or off.
{% endstep %}

{% step %}

### Keep working

Your choice is saved in this browser and applies the next time you open Protoboard. Select **High contrast mode** again to turn it off.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
High contrast mode works in both light and dark themes. When you take a screenshot of your board (**Project menu** > **Screenshot**), you can also choose **High contrast screenshot** for the exported image.
{% endhint %}

***

## Themes and motion

* **Light and dark themes:** Protoboard follows your operating system's light or dark preference. Use the theme button in the header (**Switch to dark mode** or **Switch to light mode**) to choose one yourself. Your choice is remembered in this browser.
* **Reduced motion:** Turn on "reduce motion" in your operating system or browser settings, and Protoboard suppresses its interface animations. Loading spinners keep turning so you can tell work is in progress, and static status labels stay visible, so no information depends on motion.
* **Moving content stops on its own:** for everyone, loading placeholders and animated hints stop within five seconds. The full-screen loading animation runs only while nothing else can be used.

***

## Work with the keyboard only

Every step below uses standard keys: **Tab** and **Shift+Tab** move between controls, **Enter** activates buttons and links, **Space** toggles checkboxes and buttons, and **Escape** closes dialogs and menus. None of these workflows needs ProtoBot or uses energy.

{% stepper %}
{% step %}

### Skip to the content you need

On every page, the first **Tab** stop is the **Accessibility shortcuts** bar: **Skip to main content**, **High contrast mode**, and **Accessibility help**. It stays hidden until it receives keyboard focus.

In the board editor, keep pressing **Tab** to reach **Skip to canvas** and **Skip to inspector**. Press **Enter** on either one to jump there.

You can also open the Inspector at any time with the **Open inspector panel** button.
{% endstep %}

{% step %}

### Find a part in the Parts Bin

1. Tab to the activity bar on the left and open the **Parts Bin**.
2. Type in the search field to find a part by name or description.
3. To browse by category instead, move focus into the category list. Use **Up** and **Down** to move between categories, **Home** and **End** to jump to the first or last, **Right** to open a category, and **Left** to return to its parent.
4. Tab to the part card you want and activate its **Add** button (announced as "Add *part name* to board").
5. To move past the part cards without tabbing through each one, activate **Skip parts list** at the start of the list.
6. More parts load automatically as you scroll, but automatic loading pauses while keyboard focus is in the list so the list doesn't change under you. Activate **Load more parts** at the end of the list to load the next page.

The new part appears on the canvas and in the object tree.
{% endstep %}

{% step %}

### Browse objects in the object tree

Open the Inspector. The object tree lists groups and their members, parts that are not in a group, harnesses, annotations, and annotation connections.

* **Up** and **Down** move between objects. **Home** and **End** jump to the first and last object.
* Type a letter to jump to the next object whose name starts with it.
* **Right** expands a group or moves into its members. **Left** collapses a group or returns to its parent.
* **Enter** opens the selected object in the Inspector. The canvas selects and frames it, while keyboard focus stays in the Inspector.
* The **Back to objects** button returns you to the same row in the tree.

The tree is a single Tab stop, so Tab moves past it to the next control.
{% endstep %}

{% step %}

### Create a harness (connection)

1. In the object tree, press **Enter** on the first part.
2. Activate **Create harness**.
3. In the dialog, choose the destination part from the **Destination** list and activate **Create**.
4. The new harness opens in the Inspector. Choose the interface pair, then assign functions and resources. See [Connections & Compatibility](https://docs.protoboard.xyz/editor/harnesses-and-function-links.md) for what each setting means.

Press **Escape** or **Cancel** to close the dialog without changes. Focus returns to the button that opened it.
{% endstep %}

{% step %}

### Configure parts, interfaces, and functions

Open a part or harness from the object tree to edit its fields. In text and number fields, **Enter** commits the change and **Escape** restores the previous value. Each committed change is one undo step.

Position fields (X and Y) let you move a part without dragging. Inside a group, coordinates are relative to that group.
{% endstep %}

{% step %}

### Organize with groups and notes

The canvas toolbar contains **Add blank part**, **Add note**, and **Add group**.

* **Groups:** Use the **Parent group** field on a part, note, or group to move it into another group. It keeps its position on the canvas. The group Inspector has **Ungroup** and **Delete group and members** buttons.
* **Notes (annotations):** After adding a note, open it from the object tree to write its text and set its position. Use **Connect annotation** to link it to a part, group, or another note. The connection's Inspector lets you choose which side each end attaches to and its offset along that side.
  {% endstep %}

{% step %}

### Delete and undo

Open the object and activate **Delete object**. Protoboard asks you to confirm, then removes the object and its connections. Focus returns to the object tree.

On the canvas, **Delete** or **Backspace** removes the part or harness that has focus (or the whole selection, if the focused object is selected), but only while focus is on the canvas. Keys pressed in panels, menus, or text fields never delete board objects. Protoboard announces what was deleted and returns focus to the canvas.

Press **Ctrl+Z** (**Cmd+Z** on macOS) to restore it, including its connections and group membership. Press **Ctrl+Shift+Z** (**Cmd+Shift+Z**) to redo. Undo and redo announce what changed.
{% endstep %}

{% step %}

### Review the whole board as text

Below the object tree, expand **Board text summary**. It describes every part, its connections, its group membership, and its position, using your board's actual data. If a part has no description, the summary says so.
{% endstep %}

{% step %}

### Run a design rule check

Open **Board Review** from the activity bar. DRC results are listed as text with their status name (for example, **PARTIALLY\_CONFIGURED**), so you never have to rely on the color of a harness. See [Validation (DRC)](https://docs.protoboard.xyz/validate-and-build/how-drc-works.md).
{% endstep %}

{% step %}

### Save, export, and import

* **Ctrl+S** (**Cmd+S** on macOS) saves your board. Check the save status in the header before you leave.
* Open the **Project menu** at the top left of the header for **Save to Cloud**, **Export to File**, and **Import from File**. Export creates a portable board file; import reopens a board file or pasted board data.
  {% endstep %}
  {% endstepper %}

{% hint style="success" %}
**Working on the canvas with the keyboard:** after **Skip to canvas**, the arrow keys pan the view and **Shift** plus an arrow key pans farther. Press **Enter** or **Space** to select the focused part, then use the arrow keys (with **Shift** for larger steps) to move it. **Shift+F10** opens the canvas menu. The **Zoom in**, **Zoom out**, **Frame all parts**, and **Frame selection** buttons are all reachable with Tab. The **Shortcuts and controls** button at the bottom of the canvas lists these keys in its **Keyboard** group.
{% endhint %}

***

## Typing and focus

By default, when focus isn't in another control, typing a character moves focus to the ProtoBot chat box so you can start a message right away. If this interferes with a screen reader, speech input, or single-key navigation, turn it off: open **More options** and clear **Typing moves focus to the chat box**. The setting is saved in this browser.

***

## Keyboard shortcuts

Shortcuts are turned off while you type in a text field, so they never interfere with your typing. On macOS, **Control** also works in place of **Cmd** for the shortcuts that use a modifier key.

| Action                                              | Windows / Linux                               | macOS                                         |
| --------------------------------------------------- | --------------------------------------------- | --------------------------------------------- |
| Save board                                          | Ctrl+S                                        | Cmd+S                                         |
| Undo                                                | Ctrl+Z                                        | Cmd+Z                                         |
| Redo                                                | Ctrl+Shift+Z                                  | Cmd+Shift+Z                                   |
| Redo (alternate)                                    | Ctrl+Y                                        | Control+Y                                     |
| Copy selected parts (canvas focused)                | Ctrl+C                                        | Cmd+C                                         |
| Paste parts (canvas focused)                        | Ctrl+V                                        | Cmd+V                                         |
| Delete selected parts or harnesses (canvas focused) | Delete or Backspace                           | Delete or Backspace                           |
| Select the focused part (canvas focused)            | Enter or Space                                | Enter or Space                                |
| Move the selected part (canvas focused)             | Arrow keys, Shift+Arrow keys for larger steps | Arrow keys, Shift+Arrow keys for larger steps |
| Open the canvas menu                                | Shift+F10                                     | Shift+F10                                     |
| Add to selection                                    | Shift+click or Ctrl+click                     | Shift+click or Cmd+click                      |
| Cancel placing a part                               | Escape                                        | Escape                                        |
| Pan the canvas (canvas focused)                     | Arrow keys                                    | Arrow keys                                    |
| Pan farther (canvas focused)                        | Shift+Arrow keys                              | Shift+Arrow keys                              |
| Pan with the mouse                                  | Hold Space and drag                           | Hold Space and drag                           |
| Move in the object tree or Parts Bin categories     | Up, Down, Home, End                           | Up, Down, Home, End                           |
| Expand or enter / collapse or go back               | Right / Left                                  | Right / Left                                  |
| Open an object from the tree                        | Enter                                         | Enter                                         |
| Commit / cancel a field edit                        | Enter / Escape                                | Enter / Escape                                |
| Send a ProtoBot message                             | Enter                                         | Enter                                         |
| New line in a ProtoBot message                      | Shift+Enter                                   | Shift+Enter                                   |
| Previous / next concept image                       | Left / Right                                  | Left / Right                                  |
| Close a dialog, menu, or image viewer               | Escape                                        | Escape                                        |
| Move to notifications                               | Alt+Shift+T                                   | Option+Shift+T                                |
| Move to other status messages                       | F8                                            | F8                                            |

For shortcuts grouped by task, see [Keyboard Shortcuts](https://docs.protoboard.xyz/editor/keyboard-shortcuts.md).

***

## Screen readers

Protoboard is tested with **VoiceOver on macOS in Safari**.

* The board canvas is a visual diagram. Its content is available to screen readers through the **object tree** and the **Board text summary** in the Inspector. Use these to understand and edit the board.
* Buttons that show only an icon have accessible names (for example, **Back to objects**, **Zoom in**, and **More options**).
* Menu items that turn a setting on or off, such as **High contrast mode**, are announced with their current state.
* Dialogs move focus inside when they open and return it to the control that opened them when they close.
* Notifications are announced as they appear. Press **Alt+Shift+T** (**Option+Shift+T** on macOS) to move to them, or **F8** for other status messages.
* Parts, notes, groups, and harnesses on the canvas are announced by name, type, status, and connections (for example, "Harness camera: ESP32-WROVER to Camera, partially configured").
* Save status changes (Unsaved changes, Saving…, Saved, Not saved) and ProtoBot replies are announced without moving your focus.
* **Describe your images:** open an image in **Board Identity** and fill in **Image description**. Protoboard uses it as the image's text alternative wherever the image appears.
* If typing unexpectedly moves you to the chat box, turn off **Typing moves focus to the chat box** in **More options**.

***

## Zoom, reflow, and small screens

* Browser zoom and text resizing work throughout Protoboard. As the window narrows, side panels become sheets, and focused controls scroll into view.
* The canvas itself is a two-dimensional diagram, so it pans and zooms instead of reflowing. Use the object tree and Board text summary for a linear view of the same content.
* On phone-sized screens, the canvas opens in pan-only mode so a touch cannot move or delete parts by accident. Use the canvas lock button (**Unlock canvas, allow editing**) to switch to editing.

***

## Known limitations

* Dragging parts and drawing harnesses on the canvas are pointer gestures. Every one of them has a keyboard alternative through the Parts Bin **Add** button and the Inspector, described above.
* This documentation site is hosted on GitBook. Some navigation and search controls are provided by GitBook. If one of them gets in your way, let us know and we will pass it on and help you find the information.

See the [FAQ](https://docs.protoboard.xyz/help/faq.md) for general product limitations.

***

## Report a problem or get help

An accessible PDF edition of this documentation, and our Accessibility Conformance Report, are available on request.

If you hit an accessibility barrier in Protoboard or in these docs, email <support@protoboard.ai> or use the in-app **Feedback** button. The same address handles requests for the Accessibility Conformance Report.

Include:

* What you were trying to do
* Your browser and operating system
* Any assistive technology you use (for example, a screen reader or magnifier) and its version
* The control or page where the problem happened

Avoid sending confidential board contents.

***

## Related pages

* [Keyboard Shortcuts](https://docs.protoboard.xyz/editor/keyboard-shortcuts.md): every shortcut, grouped by task
* [Canvas Basics](https://docs.protoboard.xyz/editor/canvas-basics.md): canvas navigation, modes, and themes
* [Connections & Compatibility](https://docs.protoboard.xyz/editor/harnesses-and-function-links.md): configuring harnesses
* [Troubleshooting](https://docs.protoboard.xyz/help/troubleshooting.md): fixes for common issues
