Frameworks¶
a11yst detects your web framework and uses a matching adapter for dev-server hints, route discovery, readiness, and source mapping.
Support status¶
| Framework | Route discovery | Source mapping | Notes |
|---|---|---|---|
| HTML | Filesystem .html |
Static HTML adapter | Static sites and previews |
| React | React Router paths from source | React adapter | Falls back to / with diagnostic |
| Next.js | App + Pages router scan | Next adapter | Dynamic segments may need samples |
| Vue | Explicit routes recommended | Vue adapter | No filesystem discovery in this phase |
| Nuxt | pages/ scan |
Nuxt adapter | Falls back to / when empty |
| Angular | Explicit routes recommended | Angular adapter | Reads angular.json for diagnostics |
React Native, Expo, and native mobile platforms are not currently supported for operational audits.
Detection¶
a11yst detect
a11yst detect --json
Set framework explicitly in config when detection is ambiguous.
Route discovery modes¶
| Mode | Behavior |
|---|---|
off |
Only routes listed in config |
fallback (default) |
Use adapter discovery; fall back to configured routes |
merge |
Combine configured routes with discovered routes |
a11yst routes --explain
Shows discovered routes, sources, and diagnostics per project.
Official website¶
The a11yst documentation site is MkDocs + Material with framework: "html", explicit routes, and a local preview server. See a11yst.config.ts in this repository.
Choose a guide¶
Configuration reference: Configuration.