Accessibility at Herald
Herald is a web app on the Renkara design system. It has a skip link as its first Tab stop, labeled controls, no sideways scrolling at 375 pixels, and an automated axe run that finds no critical problems. It also has 9 contrast findings from the design system's badge colors, a 16-pixel row checkbox, and a sound and fireworks effect on live events with no off switch. Nobody has tested it with a screen reader or walked it with only a keyboard, and we do not claim a conformance level.

What Herald supports today
Each line says what the product does, how we know, and where to look. “Not yet tested” means exactly that: we have not checked, and we do not claim it.
Partly supported
Keyboard operation
The first Tab stop on the dashboard is a Skip to main content link, then the Herald link, the five navigation links, the list picker, the New newsletter button, the theme button, and the account menu, in reading order. Two scroll areas that a keyboard could not enter, the Emails table and the signup embed code, were made focusable and named on 10/29/2026. Herald has no keyboard shortcuts of its own. Nobody has walked a whole flow, such as composing and sending, with only a keyboard.
Evidence
- screenshots/captures/herald-a11y.spec.ts: records the first 12 Tab stops on the dashboard at 1440 pixels in light (skip link first), 10/29/2026
- herald commits f3e7090 and 73831eb: the embed code block and the Emails scroll area are keyboard-focusable and named, each with a regression test
- @renkara/design-system AppShell: the Skip to main content link
- No keyboard-only walkthrough of any flow is on record.
Partly supported
Screen reader landmarks and labels
Controls carry accessible names: the list picker is Current newsletter, the theme button says what it will do, and the Activity page's Pause and Refresh buttons now contain their visible text in their names. An automated scan finds no critical problems and no missing names. Herald has not been tested with VoiceOver, NVDA, JAWS, or any screen reader, so how the live Activity feed and the toasts read aloud is unknown.
Evidence
- screenshots/output/herald/a11y.json: 28 axe-core 4.14 scans in Chromium, 0 critical, and the only serious rule left is color-contrast, 9 results (10/29/2026)
- frontend/src/__tests__/accessibility.test.tsx: vitest-axe on the whole app and on the dashboard, activity, subscribers, compose, emails, automations, and settings routes
- herald commit f3e7090: Refresh and pager button names contain their visible text, with tests
- No screen-reader run is on record.
Partly supported
Contrast in light and dark
Herald's magenta accent measures 5.68 to 1 against white in light mode and 5.91 to 1 against the dark card color, both above 4.5 to 1. The axe scan still reports 9 color-contrast findings: warning-tinted status badges on the dashboard, subscribers, and emails pages, a dark-mode status badge on automations, and the dark-mode red Delete text on settings. Those colors belong to the design system, not Herald, and have not been fixed. The Activity page's dimmed event labels, which were 116 to 200 failing nodes, were fixed on 10/29/2026.
Evidence
- Computed on 10/29/2026 from frontend/src/styles/global.css (--brand-accent 322 80% 42% light, 322 80% 67% dark) against the design system's card colors
- screenshots/output/herald/a11y.json: 9 serious color-contrast results across the dashboard, subscribers, emails, automations, and settings (10/29/2026)
Partly supported
Reduced motion
The design system's global stylesheet shortens every animation and transition to almost nothing when the system asks for reduced motion. Herald's own fireworks, a canvas animation that plays when a new subscriber arrives, does not check the setting, and the sound that goes with it is on by default with no switch in the app to turn it off.
Evidence
- node_modules/@renkara/design-system/dist/tokens.css: a prefers-reduced-motion rule sets animation and transition durations to near zero
- frontend/src/components/ui/Fireworks.tsx and hooks/useSound.ts: no reduced-motion check, sounds default to on, and nothing outside the hook can set them
Not yet tested
Text resize and zoom
Nobody has tested Herald at larger text sizes or browser zoom. Several tables carry small, fixed-size labels, so large text may crowd or clip them.
Partly supported
Mobile and touch
At 375 pixels no page scrolls sideways in light or dark, and the navigation collapses behind an Open navigation button. Many targets are smaller than 44 pixels: between 13 and 67 per page, and the Subscribers row checkboxes are 16 pixels. Nobody has used the app on a phone.
Evidence
- screenshots/output/herald/a11y.json: per page at 375 pixels, no horizontal overflow, and a count of targets under 44 pixels (10/29/2026)
- No on-device test is on record.
No WCAG conformance level is claimed for the Herald app. Its repository's README describes the app as WCAG 2.1 AA work and says it was tested with VoiceOver, NVDA, and JAWS; no record of those tests exists, so this site does not repeat the claim. The evidence below is what was run and read on 10/29/2026: an axe-core 4.14 scan in a real browser of six pages and the composer at 375 and 1440 pixels in light and dark (28 scans, against WCAG 2.0 to 2.2 A and AA rules plus best practices), the app's own jsdom axe tests, and the code. This site's own pages are scanned by the kit's axe-core run in the same way.
More about Herald
What was fixed while preparing this page
Running the scan found problems in Herald itself, and they were fixed with regression tests on 10/29/2026.
- The Activity page's Refresh button and the signups pager buttons had names that did not contain their visible text.
- The signup embed code and the Emails table scrolled but could not be reached with a keyboard.
- The Activity page's event type and date text was dimmed below the contrast minimum.
First Tab stops on the dashboard
Recorded in a real browser at 1440 pixels in light mode.
| 1 | Skip to main content |
|---|---|
| 2 | Herald (home) |
| 3 to 7 | Subscribers, Emails, Automations, Activity, Settings |
| 8 | Current newsletter (the list picker) |
| 9 | New newsletter |
| 10 | Theme button |
| 11 | Account menu |
| 12 | The 7 day period control |
What does not work yet
- Herald has not been tested with a screen reader, and nobody has walked a whole flow with only a keyboard.
- 9 color-contrast findings from the design system's warning-badge and destructive colors are open.
- Row checkboxes and tag chips on the Subscribers page are smaller than 44 pixels, down to 16 pixels.
- New-subscriber and send events play a sound and can fire fireworks, with no way to turn either off and no reduced-motion check on the animation.
- Larger text sizes and the Increase Contrast setting are untested, and the app was not used on a phone.
How this site is built and checked
This site targets WCAG 2.2 level AA. That is a target we build and test toward, not a certification, and no one has audited it for conformance.
Structure
A skip link, labeled landmarks (header, navigation, main, footer), one h1 per page, and headings that do not skip levels.
Keyboard and focus
Links and buttons are native elements, so they work from the keyboard. Focus is drawn as a visible ring, and the menu closes with Escape.
Contrast
Text meets 4.5 to 1 in both the light and dark themes, checked against the stylesheet by the test suite.
Motion
Transitions and animation switch off when your system asks for reduced motion.
Small screens and zoom
Layouts hold at 375 pixels wide with no sideways scrolling, text resizes with the browser, and touch targets are at least 44 pixels.
Automated scan
Every page is scanned with axe-core at 375 and 1440 pixels in light and dark, and the checks fail on any serious or critical violation. Automated tools find only part of the problems, so this is a floor, not proof.
Images
Every product screenshot has a text description and comes in a light and a dark version that follows your theme.
Your theme choice
The theme follows your system setting until you pick one with the button in the header.
Statement last reviewed 10/29/2026.