Skip to main content

Guides

Accessibility evidence

Ouro HX's accessibility claims are checked by the project's own CI. This page lets anyone run the same checks, or open the CI run behind each one, without taking the project's word. It is generated from the repository's files, so a component with no screen-reader spec shows that here rather than being left out.

What this is not. The checks are run by the project that writes the components, and no outside auditor has reviewed them. An independent audit is separate evidence and is not claimed here; the model interviews record that compliance-minded models asked for exactly that.

The four checks

axe on every story
What it proves: No axe violation in any story, closed and with each overlay open. It runs in Chromium, leaves out Base UI's focus-trap guards (test/story-axe.ts), and axe finds only part of what WCAG asks
Where it lives: test/stories.test.tsx
CI runs: main's CI runs; open a run and read its browser shards
pnpm exec vitest run --project ouro-chromium test/stories.test.tsx
Conformance matrix
What it proves: Focus handoff, announcements, right-to-left, forced colours and hydration hold for every story; an exemption is declared in the story and named in the pull request
Where it lives: test/conformance/, guide
CI runs: main's CI runs; open a run and read its conformance shards
pnpm conformance
VoiceOver on macOS
What it proves: What the screen reader says for a control's name, role and state, driven by Guidepup. Some steps pass through documented fallbacks, and the macOS 15 and strict nightly jobs are advisory
Where it lives: screen-reader specs, guide
CI runs: push, nightly and release runs
pnpm test:sr --project voiceover (macOS only)
NVDA on Windows
What it proves: The same specs, read by NVDA in Chromium
Where it lives: the same specs
CI runs: push, nightly and release runs
pnpm test:sr --project nvda (Windows only)

Some specs pass a step through a fallback or only log it, and the lane's advisory jobs do not fail the lane; the screen-reader lane's own page lists those and the other known findings recorded against VoiceOver and NVDA, with an issue for each: known findings.

Per component

Stories are counted as the export const entries of each component's *.stories.tsx files. Every one goes through the axe and conformance checks above. A screen-reader spec exists for 18 of 113 component folders; the rest are covered by axe and the conformance matrix only, and say so below.

a2ui-surface
Stories: 2
Conformance declarations: 0
none yet
accordion
Stories: 3
Conformance declarations: 0
none yet
agent-handoff
Stories: 3
Conformance declarations: 0
none yet
agent-presence
Stories: 5
Conformance declarations: 0
none yet
alert
Stories: 3
Conformance declarations: 0
none yet
app-window
Stories: 2
Conformance declarations: 0
none yet
aspect-ratio
Stories: 2
Conformance declarations: 0
none yet
attention-card
Stories: 4
Conformance declarations: 0
none yet
auth-layout
Stories: 2
Conformance declarations: 0
none yet
autocomplete
Stories: 3
Conformance declarations: 0
none yet
avatar
Stories: 8
Conformance declarations: 0
none yet
badge
Stories: 5
Conformance declarations: 0
none yet
breadcrumb
Stories: 3
Conformance declarations: 0
none yet
button
Stories: 8
Conformance declarations: 0
button.sr.spec.ts: 1 test on actions-button--loading
button-group
Stories: 2
Conformance declarations: 0
none yet
calendar
Stories: 8
Conformance declarations: 0
none yet
card
Stories: 7
Conformance declarations: 0
none yet
carousel
Stories: 4
Conformance declarations: 0
none yet
celebrate
Stories: 2
Conformance declarations: 0
celebrate.sr.spec.ts: 1 test on feedback-celebrate--in-context
chart
Stories: 5
Conformance declarations: 0
none yet
chat-header
Stories: 3
Conformance declarations: 0
none yet
checkbox
Stories: 8
Conformance declarations: 0
checkbox.sr.spec.ts: 1 test on forms-checkbox--playground
checklist
Stories: 8
Conformance declarations: 0
checklist.sr.spec.ts: 1 test on lists-checklist--in-context
choice-card
Stories: 3
Conformance declarations: 0
none yet
code-block
Stories: 5
Conformance declarations: 0
none yet
collapsible
Stories: 6
Conformance declarations: 0
none yet
color-field
Stories: 3
Conformance declarations: 0
none yet
color-scheme-toggle
Stories: 3
Conformance declarations: 0
color-scheme-toggle.sr.spec.ts: 1 test on actions-colorschemetoggle--segmented
combobox
Stories: 5
Conformance declarations: 0
none yet
command
Stories: 7
Conformance declarations: 0
command.sr.spec.ts: 1 test on menus-command--playground
composed-surface
Stories: 2
Conformance declarations: 0
none yet
composer
Stories: 11
Conformance declarations: 0
none yet
conversation-list
Stories: 10
Conformance declarations: 0
none yet
copy-button
Stories: 2
Conformance declarations: 0
none yet
cover
Stories: 3
Conformance declarations: 0
none yet
description-list
Stories: 3
Conformance declarations: 0
none yet
dialog
Stories: 14
Conformance declarations: 0
dialog.sr.spec.ts: 1 test on overlays-dialog--playground
emoji
Stories: 5
Conformance declarations: 0
none yet
emoji-picker
Stories: 7
Conformance declarations: 0
none yet
empty
Stories: 2
Conformance declarations: 0
none yet
family-bar
Stories: 5
Conformance declarations: 0
none yet
field
Stories: 7
Conformance declarations: 0
none yet
file-field
Stories: 5
Conformance declarations: 0
none yet
form
Stories: 6
Conformance declarations: 0
none yet
hero
Stories: 11
Conformance declarations: 0
none yet
hover-card
Stories: 2
Conformance declarations: 0
none yet
image-cropper
Stories: 3
Conformance declarations: 0
none yet
image-field
Stories: 3
Conformance declarations: 0
none yet
inspector
Stories: 2
Conformance declarations: 0
none yet
install-prompt
Stories: 2
Conformance declarations: 0
none yet
item
Stories: 8
Conformance declarations: 0
item.sr.spec.ts: 1 test on lists-item--in-context
kbd
Stories: 2
Conformance declarations: 0
none yet
level-meter
Stories: 3
Conformance declarations: 0
none yet
lightbox
Stories: 8
Conformance declarations: 1
none yet
link
Stories: 5
Conformance declarations: 0
none yet
live-captions
Stories: 9
Conformance declarations: 0
none yet
local-date
Stories: 4
Conformance declarations: 0
none yet
mcp-app
Stories: 2
Conformance declarations: 0
none yet
media-tile
Stories: 9
Conformance declarations: 0
none yet
menu
Stories: 6
Conformance declarations: 0
menu.sr.spec.ts: 1 test on menus-menu--playground
message
Stories: 39
Conformance declarations: 0
none yet
moment
Stories: 8
Conformance declarations: 0
none yet
navbar
Stories: 3
Conformance declarations: 0
none yet
navigation-menu
Stories: 3
Conformance declarations: 0
none yet
navigation-rail
Stories: 5
Conformance declarations: 0
none yet
number-field
Stories: 3
Conformance declarations: 0
none yet
otp-field
Stories: 2
Conformance declarations: 0
none yet
page-header
Stories: 3
Conformance declarations: 0
none yet
page-shell
Stories: 1
Conformance declarations: 0
none yet
pagination
Stories: 4
Conformance declarations: 0
none yet
popover
Stories: 5
Conformance declarations: 0
none yet
porthole
Stories: 13
Conformance declarations: 0
none yet
progress
Stories: 4
Conformance declarations: 0
none yet
radio-group
Stories: 4
Conformance declarations: 0
none yet
reaction-bar
Stories: 6
Conformance declarations: 0
none yet
read-receipt
Stories: 1
Conformance declarations: 0
none yet
relative-time
Stories: 3
Conformance declarations: 0
none yet
reorderable
Stories: 4
Conformance declarations: 0
reorderable.sr.spec.ts: 1 test on lists-reorderable--disabled
resizable
Stories: 6
Conformance declarations: 0
none yet
route-progress
Stories: 2
Conformance declarations: 0
route-progress.sr.spec.ts: 1 test on feedback-routeprogress--in-context
scroll-area
Stories: 2
Conformance declarations: 0
none yet
section-header
Stories: 2
Conformance declarations: 0
none yet
segmented-control
Stories: 4
Conformance declarations: 0
none yet
select
Stories: 7
Conformance declarations: 0
select.sr.spec.ts: 1 test on forms-select--playground
separator
Stories: 4
Conformance declarations: 0
none yet
share-button
Stories: 2
Conformance declarations: 0
none yet
sheet
Stories: 10
Conformance declarations: 0
none yet
sidebar
Stories: 12
Conformance declarations: 0
none yet
skeleton
Stories: 8
Conformance declarations: 0
none yet
skip-link
Stories: 2
Conformance declarations: 0
none yet
slider
Stories: 3
Conformance declarations: 0
none yet
snap-pip
Stories: 6
Conformance declarations: 0
none yet
spinner
Stories: 2
Conformance declarations: 0
none yet
stack
Stories: 4
Conformance declarations: 0
none yet
swipe-actions
Stories: 2
Conformance declarations: 0
none yet
switch
Stories: 3
Conformance declarations: 0
switch.sr.spec.ts: 1 test on forms-switch--playground
sync-status
Stories: 3
Conformance declarations: 0
sync-status.sr.spec.ts: 1 test on feedback-syncstatus--in-context
tab-bar
Stories: 2
Conformance declarations: 0
none yet
table
Stories: 7
Conformance declarations: 0
none yet
tabs
Stories: 6
Conformance declarations: 0
tabs.sr.spec.ts: 1 test on navigation-tabs--links
text
Stories: 9
Conformance declarations: 0
none yet
text-field
Stories: 10
Conformance declarations: 0
text-field.sr.spec.ts: 2 tests on forms-textfield--states, forms-form--server-errors
theme-picker
Stories: 2
Conformance declarations: 0
none yet
thread-layout
Stories: 3
Conformance declarations: 0
none yet
thread-rail
Stories: 2
Conformance declarations: 0
none yet
time-grid
Stories: 10
Conformance declarations: 0
none yet
timer
Stories: 10
Conformance declarations: 0
timer.sr.spec.ts: 1 test on feedback-timer--short
toast
Stories: 6
Conformance declarations: 2
toast.sr.spec.ts: 1 test on feedback-toast--playground
toggle
Stories: 7
Conformance declarations: 0
none yet
toolbar
Stories: 7
Conformance declarations: 0
none yet
tooltip
Stories: 2
Conformance declarations: 0
none yet
typing-indicator
Stories: 1
Conformance declarations: 0
none yet
unread-dot
Stories: 2
Conformance declarations: 0
none yet

Screen-reader specs that cover a pattern rather than one component:

  • patterns.sr.spec.ts: a row is heard by its title, its entry's heading as the detail takes the list's place, and the row again after Back; a search that finds nothing says so; its chart and its table's scrolling region are heard by their names

What each screen-reader test says it proves

The test titles, in the words of the specs, so a reader sees the claim before opening the file.

  • button

- Button is announced with its name and role, and its busy state from the live region when loading turns on

  • celebrate

- Celebrate says its message once when the last task is ticked

  • checkbox

- Checkbox is announced with its name, role and state, and its change when checked

  • checklist

- Checklist announces an item's name, role and state, and its change when ticked

  • color-scheme-toggle

- ColorSchemeToggle is announced as a radio group of schemes, and the scheme chosen with the arrow keys as checked

  • command

- Command reads each command the arrow keys reach from the search, which keeps focus

  • dialog

- Dialog is announced with its title and role when it opens, and its trigger again when it closes

  • item

- An Item with href is heard as a link by its title, then its description

  • menu

- Menu is announced from its trigger, reads each item the arrow keys reach, and returns to the trigger on Escape

  • reorderable

- A disabled Reorderable's handles are heard as unavailable buttons, without the pick-up instructions

  • route-progress

- RouteProgress is announced once from its status region when a navigation starts

  • select

- Select is announced with its label, role and state, and its new value when one is chosen

  • switch

- Switch is announced with its name, role and state, and its change when turned on

  • sync-status

- SyncStatus is heard when the connection goes, and when changes are saved again

  • tabs

- Tabs that are links are announced as links, the current one as the current page

  • text-field

- TextField is announced with its label, role and required state, and its description - TextField's error from a submit is announced as focus moves to the field

  • timer

- Timer's Start is heard in its named group, and the time being up is announced once

  • toast

- Toast is announced from its live region when it appears

Rerun it

  1. Clone the repository and run pnpm i.
  2. Run pnpm exec vitest run --project ouro-chromium test/stories.test.tsx for axe, and pnpm conformance for the matrix.
  3. On macOS or Windows, run pnpm test:sr --project voiceover or --project nvda for the screen-reader lane; the guide lists what the runner needs.
  4. To read a CI result without running anything, open a run from the links above and read the job's result and log.

This page is rendered by scripts/a11y-evidence/page.mjs; pnpm claims:check renders it again and compares, so it cannot drift from the files it counts.