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@next

Need help?

Join the #addons channel 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.

Oct 20 '25 14:10 Sidnioulz

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.

Oct 20 '25 14:10 bashmish

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.

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 ;-) )

Oct 20 '25 14:10 Sidnioulz

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.

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 ;-) )

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

Oct 21 '25 08:10 bashmish