axle-netlify-plugin
v1.0.2
Published
Netlify a11y / WCAG 2.2 AA accessibility build plugin — scan the deploy preview for accessibility violations, fail the build on regressions, post summary to the deploy log. Built for EAA 2025, ADA, Section 508.
Maintainers
Readme
axle-netlify-plugin
Netlify Build Plugin that runs the axle accessibility scanner against your deploy-preview URL and fails the build on WCAG regressions.
Install
# netlify.toml
[[plugins]]
package = "axle-netlify-plugin"
[plugins.inputs]
failOn = "serious" # critical | serious | moderate | minor | none
withAiFixes = false # set true + ANTHROPIC_API_KEY env to enable AI diffs
maxAiFixes = 10
# url = "https://preview.mydomain.dev" # optional overrideSet ANTHROPIC_API_KEY in Netlify site → Environment if you want AI fix suggestions in the build log.
What it does
- Waits for Netlify to finish the build.
- Reads the deploy-prime URL from
DEPLOY_PRIME_URL. - Runs
axle-cli scanagainst it with your threshold. - Writes
axle-report.json+axle-report.mdnext to yourpublishdir (so you can download them from the deploy). - Fails the build if violations meet or exceed
failOn.
Not a compliance certificate
Remediation assistance only. Manual human review still recommended for full WCAG conformance.
Learn more: axle-iota.vercel.app · GitHub
