storybook-a11y-report
CLI tool for storybook-addon-a11y.
storybook-a11y-report is no longer maintained, please use Storybook test runner and axe-playwright instead!
The storybook-a11y-report project is now discontinued. Please switch to the Storybook test runner and axe-playwright for accessibility testing. We thank everyone who supported storybook-a11y-report throughout its journey.
Report Example
Getting Started
Prerequisites
If you are already developing in Storybook and storybook-addon-a11y is working, this module will work. If storybook-addon-a11y is not installed, start with this guide.
Installing / Getting started
# Locally in your project.
npm install -D storybook-a11y-report
# Or globally.
npm install -g storybook-a11y-report
# You will need to start Storybook before running this command.
npx storybook-a11y-report
Options
--include, -i Name of stories to narrow down (supports minimatch)
--exclude, -e Name of stories to ignore (supports minimatch)
--filter, -f ID of A11y to narrow down
--omit, -o ID of A11y to ignore
--exit, -q The process will be terminated abnormally, if there is an a11y violation in the report result (mainly for CI)
--storybookUrl URL of Storybook (default: 'http://localhost:6006')
--outDir Directory to output the report file (default: '__report__')
--outputFormat Format of the output report, supports md or html (default: md)
Built With
- Storycrawler - Utilities to build Storybook crawling tools with Puppeteer
- storybook-addon-a11y - Test components for user accessibility in Storybook
- minimatch - A minimal matching utility
License
This project is licensed under the MIT License - see the LICENSE file for details.