← Back to list
01Issue
BugShippedSwamp CLIPublic
Assigneesskunk-ape
Relationships
#4968 stagecraft studio: the default look passes axe and WCAG AA for graphics (journal tick contrast, graph tree ARIA, panel keyboard scroll)
Opened by skunk-ape · 11/20/2026· Shipped 11/20/2026
Problem
An accessibility review during #4939 (axe-core for WCAG 2.0, 2.1 and 2.2 A/AA, plus contrast measurements in light and dark) found three problems in the studio's default look. They aren't caused by theming; they show with or without a theme.
- Journal tick colours are below the contrast floor for graphics. The built-in tick colours (move, record, wait, override, refused) measure 1.4–2.5:1 against the panel in light mode and 1.6–3.8:1 in dark mode, below WCAG's 3:1 for non-text graphics (1.4.11).
check_themealready warns when a theme's ticks fall below 3:1, so the default currently fails its own check. - Graph tree items have no tree parent. axe reports
aria-required-parenton the graph's 21treeitemelements (gt-*): their group isn't inside the element withrole="tree", so assistive technology can't place them in the tree. - The Design panel's scrolling body can't be reached by keyboard. axe reports
scrollable-region-focusableon#panel-body: a keyboard user can't scroll it when it overflows.
What to change
- Built-in tick colours reach at least 3:1 against every surface they sit on, in light and dark, keeping their hues distinguishable from each other. This changes the default look slightly.
- The graph's ARIA structure is valid: each
treeitemis owned by the tree (directly or through agroupinside it). Keyboard navigation of the graph doesn't change. #panel-bodyis reachable and scrollable by keyboard (for exampletabindex="0"with an accessible name, or making its first focusable content scroll it into view), without adding a stray tab stop when it doesn't overflow.
Done when
- axe-core (WCAG 2.0, 2.1, 2.2 A/AA) reports no violations on any studio view (Design, Simulate, Board, work item, Ticket) in light and dark, with no theme and with the shipped example theme.
check_themereports no contrast warnings for the built-in theme.- A test fails if a built-in tick colour falls below 3:1 on its surfaces.
- Screenshots of the ticks before and after, in light and dark.
Out of scope
Theming changes beyond the built-in tick values, white-labelling the wordmark, and other studio features.
02Bog Flow
Shipped
Click a lifecycle step above to view its details.
03Sludge Pulse
Sign in to post a ripple.