Accessibility

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.

Illustration: a quiet public reading room in soft light, with a wide level entrance, a low service counter, and clear open aisles between the shelves.
The product

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.

Product notes

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.

First Tab stops on the dashboard
1Skip to main content
2Herald (home)
3 to 7Subscribers, Emails, Automations, Activity, Settings
8Current newsletter (the list picker)
9New newsletter
10Theme button
11Account menu
12The 7 day period control
Known gaps

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.
This website

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.