Skip to main content
← 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.

  1. 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_theme already warns when a theme's ticks fall below 3:1, so the default currently fails its own check.
  2. Graph tree items have no tree parent. axe reports aria-required-parent on the graph's 21 treeitem elements (gt-*): their group isn't inside the element with role="tree", so assistive technology can't place them in the tree.
  3. The Design panel's scrolling body can't be reached by keyboard. axe reports scrollable-region-focusable on #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 treeitem is owned by the tree (directly or through a group inside it). Keyboard navigation of the graph doesn't change.
  • #panel-body is reachable and scrollable by keyboard (for example tabindex="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_theme reports 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
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 7 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

11/20/2026, 11:15:49 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
skunk-ape assigned skunk-ape11/20/2026, 8:24:27 PM

Sign in to post a ripple.