dsh-a11y-scan

Manual WCAG audits on front-end projects are slow, inconsistent, and easy to half-finish. dsh-a11y-scan wraps the axe-core engine as a first-class DSH tool: point it at a single HTML file, a build-output directory (Vite, Next.js, etc.), or a user-confirmed URL, and it returns a structured violation report—each finding tagged with its rule ID, impact severity, the applicable WCAG 2.1 criterion (e.g., 1.4.3 Contrast), the affected element's selector and failure summary, plus a concrete remediation hint and an official quickref link.

The tool is strictly read-only and will never modify source code. Reports can be exported as Markdown, a self-contained single-file HTML (openable offline, no external assets), or raw JSON, making it easy to drop into documentation, share with stakeholders, or pipe into downstream automation. Items that axe-core cannot definitively judge—focus-order semantics, keyboard-only interaction paths, screen-reader reading order—are collected into a dedicated manual-review checklist alongside the automated results, so nothing silently disappears.

It is designed as a programmable, standalone tool: a single a11y_scan call yields a structured return value that slots naturally into CI gates, Workflow pipelines, or agent loops. It suits front-end teams that want accessibility checks on every commit rather than a pre-launch scramble, design and product roles that need periodic compliance reports, and hybrid workflows where a deterministic scan produces the hit list first and a conversational agent interprets the borderline cases second.