Our standard
WCAG 2.2 AA, designed in from the first sketch and checked on every release, not audited in at the end. What has been tested, and what hasn't yet, is shown for each component.
The standard
Everything in Somnia DS, and everything built with it, aims to meet the Web Content Accessibility Guidelines 2.2 at level AA. Where a component falls short, or hasn't been checked, its page says so. Component checks shows every component's results side by side.
How we test
| Check | How | When |
|---|---|---|
| Automated | axe-core on every page, in light and dark | Each release |
| Contrast | Every text and surface pair, calculated from the tokens, in both themes and both brands | Every build (see Colour) |
| Structure | One h1, heading order, hero shape | Every build (the layout check) |
| Keyboard | A script works each component's live example with real key presses and checks what the browser reports (Component checks); by hand for anything a script can't judge | Each release, for the components written up so far |
| Screen reader | VoiceOver on macOS and iOS, NVDA on Windows | Not done yet. The first full pass is the next piece of accessibility work, and until then each component's page says so |
| Zoom and reflow | 320 px width without horizontal scrolling, by script; 200% and 400% zoom by hand | Each release (320 px); each new page type (zoom) |
| Motion | Reduced-motion setting on | Anything that moves |
Lessons that became rules
- Test with errors showing. Automated checks on a quiet form missed an error colour that failed in dark mode. Now error colour is its own token and checked in both themes.
- Theme-flipping colours can fail twice. A token that's fine in light can fail in dark. Every pair is checked in both.
- Don't skip heading levels. A visual h4 under an h2 confuses screen reader navigation; style the right level instead.
- Never remove focus outlines without replacing them with something at least as visible.
- Text over video needs a fixed-colour pill. The theme accent measured 1.1:1 against parts of the About video.
WCAG 2.2 specifics
- Target size (2.5.8): controls are at least 24 × 24 px; most are 38 px or more.
- Focus not obscured (2.4.11): the page reserves the sticky header's height with
scroll-padding-top, so a focused or linked-to element is never hidden beneath it. - Accessible authentication (3.3.8): the sites have no sign-in. Somnia CMS signs people in with a code sent by email, which can be pasted, or with a passkey; no puzzles.
- Redundant entry (3.3.7): forms never ask for the same thing twice.
See the site's accessibility statement for how to report a problem.