Repository navigation
Storybook 10 support聽#2989
Description
Storybook 10 support
Hi there! 馃憢
The Storybook team is excited to announce that Storybook 10.0.0 is coming soon with one major breaking change: Storybook is switching to ESM-only! For addons, this means simpler build scripts and an easier maintenance going forward.
What's changing?
The key changes that affect addon authors are:
- Addon build scripts must output ESM-only
- Some files in your addon repository must be changed to support ESM-only
What do you need to do?
- Review the addon migration guide
- Adjust your repository following the guide's recommendations
- Update your addon's dependencies:
{
"peerDependencies": {
// Keep it at *.0.0 for broader compatibility
"storybook": "^10.0.0"
},
"devDependencies": {
// You can also use 'next' if you always want to use prereleases
"storybook": "^10.0.0"
}
}- Test your addon with the prerelease version:
npm install --save-dev storybook@nextNeed help?
- Join the
#addonschannel on the Storybook Discord for support - Report any issues here
Please let us know if you plan to support Storybook 10 or if you need any assistance with the migration. Your addon is an important part of the Storybook ecosystem and we're here to help! 馃檹
If you don't have time to update your addon to Storybook 10, please consider finding coworkers or contributors who can help you maintain it. The storybook-community can provide support to contributors who volunteer to take over unmaintained addons.
This issue was created as part of our outreach to help the addon ecosystem upgrade to Storybook 10. If you have any feedback about this process or would like to opt-out from future outreach, please let us know on Discord.
Activity
bashmish commentedon Oct 20, 2025
Switching to ESM fully is a big news, great to see that coming!
We usually stay one version below the Storybook latest major, because it's difficult for us to support the pace with which Storybook updates between minor version and we ran into bugs because of that in the past.
Having that said, supporting Storybook 9 it still a TODO, in the past we released support for Storybook X a few weeks after Storybook X+1 was released, so basically Storybook 10 will take a bit of time.
Sidnioulz commentedon Oct 20, 2025
Gotcha!
You'll be happy to hear that Storybook 10 will be much easier to migrate to than Storybook 9. The guide for v9 is here, and after SB 10 release, it might move here.
I'm making those issues automatically from a script, so please let me know if you want to opt out for future versions (though I recommend keeping the issue as it has all the information at hand ;-) )
bashmish commentedon Oct 21, 2025
Thanks for the heads-up! Please keep it, it's a nice and kind way to notify people about the update and have a little discussion right away about the plans.
The migration between Storybook 7 and 8 was also pretty smooth, pretty sure it will be the same for 8->9->10