Skip to main content

Keyboard & accessibility

The app is built to WCAG AA. Every interactive element is reachable from the keyboard, every icon-only button has a screen-reader label, and color is never the only signal of state.

KeyAction
Tab / Shift+TabMove forward / backward through focusable elements.
EnterActivate the focused button or link.
SpaceToggle a checkbox / activate a button.
EscClose modal, drawer, or dropdown.
Cmd/Ctrl + KOpen the global search palette.
?Show keyboard shortcut help on any page.

Within a list page

KeyAction
/ Move row selection.
EnterOpen the focused row.
g then fOpen the filter drawer.
g then eExport the current view.
/Focus the search box.

Within a detail page

KeyAction
19Jump to tab N.
[ / ]Previous / next item in the list you came from.
eEdit (where edit is available).
Cmd/Ctrl + SSave.

Within the rules / mappings YAML editor

The Monaco editor uses standard VS Code keybindings. Notable additions:

KeyAction
Cmd/Ctrl + .Trigger schema-aware quick-fix.
Cmd/Ctrl + Shift + VOpen dry-run panel.
Cmd/Ctrl + Shift + PPublish (requires required role).
F1Command palette.

Screen reader notes

  • Loading regions announce Loading… then the row count when the table fills.
  • Toasts announce automatically; you do not need to focus them to hear them.
  • Charts include a hidden aria-label summary describing the trend direction and most recent value.
  • Step lists in this manual are ordered <ol> elements; they are numbered correctly by every screen reader.

Color and contrast

  • Text contrast meets 4.5:1 (WCAG AA) on every background.
  • Status pills use both color and an icon (✓ ✕ ⚠) so red/green colorblindness does not change the meaning.
  • The dark/light theme toggle is in your profile menu, top-right.

Reporting an accessibility issue

If you find a place that is hard to use with the keyboard or a screen reader, report it via the Issues queue (/issues) — choose category "Accessibility". Issues filed there are routed directly to the product team and prioritized over feature work.

See also