Capybara Accessibility Audit is a Ruby gem that automatically audits web pages for WCAG Standards-based accessibility violations within Capybara-powered system tests.
The tool solves the problem of catching accessibility regressions during test execution by hooking into common Capybara actions like visit, click_button, click_link, and click_on. After each of these actions, the gem automatically runs an accessibility audit using axe-core, which checks the rendered page against WCAG standards. Violations cause test failures, making accessibility issues visible during the development and testing workflow rather than discovered later.
Teams building Rails applications with system tests should adopt this tool if accessibility compliance matters to their project. It requires minimal setup—installing the gem automatically configures audits—and offers fine-grained control through configuration options that let you specify which accessibility standards to check against, which rules to enforce or skip, and which page regions to audit. The tool integrates with Active Support's instrumentation system, allowing teams to subscribe to notifications when audits run or violations are detected, enabling custom logging or reporting workflows.
The project maintains steady engagement with regular commits addressing bug fixes and feature improvements. Pull requests receive timely review and feedback from maintainers. The codebase shows active maintenance through consistent updates to dependencies and responsiveness to reported issues.
