Accessibility
Accessibility statement
Notbroken is meant to be usable by everyone. Here is what works, how it is checked, what still falls short, and how to tell us.
In short
- Notbroken aims to meet the Web Content Accessibility Guidelines (WCAG) 2.2 at level AA. It is not fully there yet: the known gaps are listed below.
- If something gets in your way, email nathan@bigbang.business. We aim to reply within two business days and to fix what we can.
What works
- Keyboard. Pages and tools are built to work with a keyboard alone: the focus is shown, and dialogs keep the focus inside until they close.
- Screen readers. Pages use headings, landmarks and labelled controls, and icon buttons have spoken names.
- Zoom and small screens. Pages reflow down to 320 pixels wide without sideways scrolling, so text can be enlarged.
- Motion. If your device asks for reduced motion, animations are switched off or kept still, including Sing’s heart and the celebrations.
- Contrast. Text is checked against the AA contrast ratio.
- No time limits on reading or filling anything in, except the Build games, which are timed by design.
How it is checked
Before each release, automated accessibility checks (axe-core) run on every kind of page — the directory, each tool, recipe, video, song and listing pages — at phone and desktop sizes, and a set of tests checks keyboard use, focus, dialog behaviour, reflow at 320 pixels and reduced motion. These checks find many problems but not all of them, and Notbroken has not yet had a full review by people who use assistive technology every day.
Known limits
- Videos. Recipe, exercise and song videos play in YouTube’s own player, whose controls and captions are YouTube’s. Captions are switched on for songs; for the other videos, the recipe method and the video summaries give the content in text.
- Calm and Breathe are visual pacers by nature; both can also give sound cues.
- Build’s brain games rely on speed, sight and sometimes sound, so they will not suit everyone; trivia has no time limit.
- PDFs (the directory’s chapter PDFs, recipe cards, journal and plan exports) are made for printing and may not read well with every screen reader; the same information is on the web pages.
- Charts in Track show trends visually; the numbers behind them are in the journal itself.