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

CheckHowWhen
Automatedaxe-core on every page, in light and darkEach release
ContrastEvery text and surface pair, calculated from the tokens, in both themes and both brandsEvery build (see Colour)
StructureOne h1, heading order, hero shapeEvery build (the layout check)
KeyboardA 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 judgeEach release, for the components written up so far
Screen readerVoiceOver on macOS and iOS, NVDA on WindowsNot done yet. The first full pass is the next piece of accessibility work, and until then each component's page says so
Zoom and reflow320 px width without horizontal scrolling, by script; 200% and 400% zoom by handEach release (320 px); each new page type (zoom)
MotionReduced-motion setting onAnything 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.