Storybook 8.5
Accessibility at your fingertips
Storybook is the industry standard workshop for building, documenting, and testing UI components. Hundreds of thousands of developers use it every week, including teams at Brex, Slack, and Audi.
Storybook Test is our effort to bring best practice component testing to frontend development by making it fast and easy. Component tests are fast because you don’t need to spin up your entire product stack to test your UI. And Storybook’s component tests are easy because we have a better way to write, run, and debug tests with realtime feedback.
But just because a UI works as intended doesn’t mean that it's accessible for everybody. Even carefully crafted user interfaces can unintentionally exclude users with visual, auditory, motor, or cognitive impairments.
That’s why I’m excited to announce Storybook 8.5. We’ve upgraded Storybook’s popular Accessibility (a11y) addon to run Axe a11y checks against all your stories as you develop. This makes it dramatically easier to ensure that your UIs meet basic a11y guidelines.
Storybook 8.5 includes:
- ♿️ Realtime accessibility tests to help build UIs for everybody
- 🛡️ Project code coverage to measure the completeness of your tests
- 🎯 Focused tests for faster test feedback
- ⚛️ React Native Web Vite framework for testing mobile UI
- 🎁 Storybook test bootcamp to level up your testing game
- 💯 Hundreds more improvements
Realtime accessibility tests
Accessibility (a11y) is increasingly required in modern user interfaces. It is becoming mandated for private service, e.g. the European accessibility act which goes into law in June 2025, and is already enforced for many government services around the world.
Storybook’s Accessibility addon, @storybook/addon-a11y
, checks your stories for common a11y issues. It’s built on axe-core
, an industry standard library that checks the DOM with a suite of rules that implement the Web Content Accessibility Guidelines (WCAG) as well as a collection of best practices.
Until now, you would browse to a story, diagnose its violations, and then fix them.
This is a great workflow to manually improve your UI’s accessibility. However, it does not help you understand the impact of a code change across your entire UI.
Now in Storybook 8.5, you can run the same a11y suite across your entire Storybook, and get realtime feedback on every story, with just one click of a button. Please stay tuned for a detailed post on the accessibility improvements!
Project code coverage
One huge benefit of component tests is that they are fast and relatively flake-free. This means that you can cover all key UI states in your tests — something that is not practical with end-to-end tests.
But how do you know what’s been tested? Code coverage measures which lines/branches of your UI code are getting run with each of your tests, and is a great way to help ensure that your test suite is complete.
To surface this information, we’ve built coverage into Storybook Test UI:
When you opt in, Storybook Test collects coverage during a test run and displays a summary in UI. Click on the results to bring up a full report, where you can see the detailed results for each file in your project, and even the individual lines/branches.
Storybook Test Coverage is available in Storybook 8.5. Please see the documentation for details.
Focused tests
Storybook Test is built on the principle of instant feedback, which is why it surfaces test results in the workshop where you build your components. We’ve partnered with Vitest for blazing fast tests, but full test runs can slow down as your Storybook grows to hundreds or thousands of stories.
That’s why we’ve introduced Focused Tests, which lets you test a single story, component, or group of components in Storybook’s hierarchical sidebar. In practice, we’ve found this helpful while working on components that aren’t reused, while still having the safety of a full test run in CI to catch unknown issues.
Storybook Focused Tests are available in Storybook 8.5. Please see the documentation for details.
React Native Web Vite framework
The recently-released React Native Storybook 8 provides a next-level experience for building out React Native (RN) user interfaces in native fidelity on your mobile device or simulator.
But what if you want to document your native components with Storybook Docs or test them with Storybook Test? The React Native Web Vite (RNW-Vite) framework uses React Native Web to render your RN stories in the browser. And unlike the native version, it is fully compatible with Storybook’s 500+ public addons.
RNW-Vite is an officially supported framework that will replace the community-maintained, Webpack-based RNW addon. It is faster and easier to setup than its predecessor, and is compatible with Storybook Test, which requires a Vite-based framework.
RNW-Vite is available in Storybook 8.5. Please see the documentation for details.
Storybook Test bootcamp
Over the past two months, we completed the first iteration of the Storybook Test early access program. 400+ participants joined us to kick the tires and provide feedback on the new testing features with hands-on help from the Storybook maintainers. Storybook 8.5 is a product of their feedback! Huge thanks to everyone who took part!
We’ve decided to continue the program—this time as the Storybook Test Bootcamp—to help even more folks get excited about testing in Storybook, especially now that accessibility and coverage tests are available. We’ll be sending out more details soon, so sign up to learn more.
👉 Sign up for the Storybook Test Bootcamp
Hundreds more improvements
In addition to the features above, every Storybook release contains hundreds of improvements and bug fixes at every level. Some highlights:
- ✅ React 19 support
- ✅ Vite 6 support
- ✅ Angular 19 support #29659 #29677
- ✅ Code addon panel #29253
- ✅ Experimental Bun support #29267
- ✅ Svelte Storybook Test support #30105
- ✅ Experimental Nuxt support #28607
Try it today!
Storybook 8.5 is available today. Try it in a new project:
npx storybook@latest init
Or upgrade an existing project:
npx storybook@latest upgrade
If you’re upgrading from 7.x, we have a guide to help you. We also have a guide for migrating from older versions.
What’s next?
We have one more minor release before Storybook 9. Here’s what's cooking.
- CSF factories for typesafety and autocompletion
- Test and Docs install for new projects
- Storybook Test fixes and improvements
For an up-to-date view on what we’re working on and considering, check out Storybook’s roadmap.
Credits
Huge shoutout to the 36 contributors whose PRs feature in Storybook 8.5!
@borgund @daleseo @dannyhw @ghengeveld @grantwforsythe @ianvs @ingowagner @jameshenry @joca96 @johannesfischer @jonniebigodes @jreinhold @kasperpeulen @kylegach @larsrickert @leosvelperez @mrginglymus @ndelangen @radovenchyk @rdebeasi @schallerala @sentience @shilman @sidnioulz @slax57 @spanishpear @tmeasday @tobiasdiez @toothlessdev @valentinpalkovic @valeras @vanessayuenn @yannbf