Cookbook

Practical recipes for common a11y-hud tasks.

Recipes

How to trigger a fresh axe scan after a client-side route change in React Router, Vue Router, Angular Router, SvelteKit, and Solid Router.

Use the headless runScan() API in Playwright tests or a Node script to fail CI when accessibility violations are detected.

Override severity and accent colors via CSS custom properties — including per-page overrides and dynamic theme switching.

How a11y-hud interacts with Content Security Policy, and what directives you need for the CDN / bookmarklet paths.

The end-to-end workflow for QA reviewers on staging: generating, installing, and using the bookmarklet without touching the app's source.

How to mute rules or specific nodes in the panel UI, export ignore lists as JSON, and share them across your team.

Reading the tab-order overlay, understanding keyboard violations, and using the headless keyboard helpers in tests.

The dev-only trust model, scope injection behavior, ignore-rules validation, violation HTML rendering context, and Shadow DOM isolation.