With Storybook 9 coming soon, we've created an addon migration guide to summarize the important changes for addon creators. The most significant change in this release is the consolidation of Storybook packages into a single storybook package, which will affect most addons. All addon creators are encouraged to review the latest changes and assess their addons for compatibility.

FAQs

I'm maintaining an addon. How do I make it compatible with Storybook 9?

We highly recommend consulting our addon migration guide. The key changes you'll need to address are:

1. Updating your package dependencies to use the consolidated storybook package
2. Updating your import paths to use the new package structure

If you have any questions or encounter any issues, please reach out to Storybook maintainers in the Storybook Discord community.

What can I do if an addon I use is incompatible with Storybook 9?

To report incompatibility issues:

1. Open an issue on the addon's repository
2. Share a link to our addon migration guide
3. Provide details about any error messages or unexpected behavior you encounter

It's also really useful for us to know which addons aren't yet compatible. Please consider:

• Contributing to the addon's migration yourself if you have the resources
• Sharing your migration experience to help other addon authors

What is the release plan for Storybook 9

You can track the release dates of Storybook 9 here.

I want to start migrating my addon early. What should I do?

1. Install the prerelease version of Storybook 9:

npm install --save-dev storybook@next

2. Update your addon's peer dependencies to include Storybook 9:

{
  "peerDependencies": {
    "storybook": "^9.0.0"
  }
}

3. Test your addon thoroughly and report any issues you encounter

Thank you for being part of our addon community! Together, we're making Storybook better for everyone. 🙇

Most downloaded community addons

We will use this list to track outreach to the maintainers of these most downloaded community addons.

Community Addon outreach

• ✅ storybook-dark-mode: [Storybook 9] Addon compatibility - Update needed hipstersmoothie/storybook-dark-mode#295
• ❌ msw-storybook-addon: [Storybook 9] Addon compatibility mswjs/msw-storybook-addon#170
• ✅ storybook-18n: [Storybook 9] Addon compatibility - Update needed stevensacks/storybook-i18n#23
• ❌ storybook-addon-mock: [Storybook 9] Addon compatibility - Update needed linearlabs-workspace/storybook-addon-mock#228
• storybook-react-i18next: [Storybook 9] Addon compatibility - Update needed stevensacks/storybook-react-i18next#34
• storybook-addon-remix-react-router: [Storybook 9] Addon compatibility - Update needed JesusTheHun/storybook-addon-remix-react-router#92
• storybook-addon-apollo-client: [Storybook 9] Addon compatibility - Update needed lifeiscontent/storybook-addon-apollo-client#132
• storycap: [Storybook 9] Addon compatibility - Update needed reg-viz/storycap#1007
• storybook-builder-rsbuild: [Storybook 9] Addon compatibility - Update needed rspack-contrib/storybook-rsbuild#260
• storybook-addon-performance: [Storybook 9] Addon compatibility - Update needed atlassian-labs/storybook-addon-performance#158
• storybook-addon-deep-controls: [Storybook 9] Addon compatibility - Update needed eliasm307/storybook-addon-deep-controls#52
• storybook-mock-date-decorator: [Storybook 9] Addon compatibility - Update needed bitttttten/storybook-mock-date-decorator#11
• @storybook/addon-queryparams: [Storybook 9] Addon compatibility - Update needed addon-queryparams#13
• storybook-vue3-router: [Storybook 9] Addon compatibility - Update needed NickMcBurney/storybook-vue3-router#68
• ✅ storybook-addon-mock-date: [Storybook 9] Addon compatibility - Update needed k35o/storybook-addon-mock-date#10
• storybook-addon-rtl: [Storybook 9] Addon compatibility - Update needed literalpie/storybook-addon-rtl#30
• @nuxtjs/storybook: [Storybook 9] Addon compatibility - Update needed nuxt-modules/storybook#878
• storybook-addon-module-mock: [Storybook 9] Addon compatibility - Update needed ReactLibraries/storybook-addon-module-mock#21
• ✅ storybook-addon-tag-badges: [Storybook 9] Addon compatibility - Update needed Sidnioulz/storybook-addon-tag-badges#66
• storybook-react-context: [Storybook 9] Addon compatibility - Update needed tyom/storybook-react-context#1
• storybook-addon-fetch-mock: [Storybook 9] Addon compatibility - Update needed JohnAlbin/storybook-addon-fetch-mock#29
• storybook-addon-react-docgen: [Storybook 9] Addon compatibility - Update needed hipstersmoothie/storybook-addon-react-docgen#143
• storybook-formik: [Storybook 9] Addon compatibility - Update needed bbbtech/storybook-formik#80
• storybook-xstate-addon: [Storybook 9] Addon compatibility - Update needed SimeonC/storybook-xstate-addon#60
• storybook-addon-test-codegen: [Storybook 9] Addon compatibility - Update needed igrlk/storybook-addon-test-codegen#22
• storybook-mirage: [Storybook 9] Addon compatibility - Update needed eliasm307/storybook-addon-deep-controls#52
• storybook-addon-badges: [Storybook 9] Addon compatibility - Update needed geometricpanda/storybook-addon-badges#32
• storybook-addon-status: [Storybook 9] Addon compatibility - Update needed etchteam/storybook-addon-status#74
• storybook-addon-vite-mock: [Storybook 9] Addon compatibility - Update needed node-libraries/storybook-addon-vite-mock#2
• storybook-mobile-addon: [Storybook 9] Addon compatibility - Update needed stevensacks/storybook-mobile-addon#4
• storybook-zeplin: [Storybook 9] Addon compatibility - Update needed zeplin/storybook-zeplin#87
• visual-testing: Storybook 9 repobuddy/visual-testing#258