Skip to content

Conversation

@khawkins98
Copy link
Collaborator

Upgrades Storybook from v9.x to v10.0.7.

Changes

  • All @storybook/* packages upgraded to 10.0.7
  • Removed @storybook/addon-actions and @storybook/blocks (now in core)

ESM Migration (required for Storybook 10)

  • Added "type": "module" to package.json
  • Converted all config files to ESM format:
    • babel.config.js, webpack.config.js, webpack.entries.js
    • jest.config.js, jest.setup.js, .releaserc.js
    • .storybook/presets.js
  • Updated import paths in all MDX files:
    • @storybook/blocks → @storybook/addon-docs/blocks

Temporarily Disabled Addons

These addons don't yet support Storybook 10 and have been commented out in .storybook/main.js:

  • storybook-design-token - design token documentation
  • @whitespace/storybook-addon-html - HTML preview
  • storybook-addon-rtl - RTL support

Closes #624

@github-actions
Copy link

🔍 Visual review for your branch is published 🔍

Here are the links to:

@khawkins98
Copy link
Collaborator Author

khawkins98 commented Nov 20, 2025

@khawkins98 khawkins98 changed the title feat: prep for storybook 10 feat: update to Storybook 10 Nov 20, 2025
@khawkins98
Copy link
Collaborator Author

@svlcek-cge -- I've done some PR work and forks to get the two addons working.

Maybe let's give a few days and see if any get merged in, otherwise perhaps we can go with the temporary fixes for now.

@svlcek-cge
Copy link
Collaborator

@svlcek-cge -- I've done some PR work and forks to get the two addons working.

Maybe let's give a few days and see if any get merged in, otherwise perhaps we can go with the temporary fixes for now.

Full on OS contributor, kudos!

@khawkins98 khawkins98 marked this pull request as ready for review December 1, 2025 09:41
@khawkins98
Copy link
Collaborator Author

Some AI features and opportunistic updates in SB 10:

New features:

  • Enabled experimentalComponentsManifest for AI tool integration - generates component metadata accessible at
    /index.json
  • Added new "AI and MCP integration" documentation page under Getting Started

Cleanup:

  • Removed deprecated @storybook/blocks (merged into addon-docs in SB 10)
  • Removed redundant @storybook/addon-actions (bundled in SB 10)
  • Migrated preview.js to modern default export pattern
  • Switched from react-docgen-typescript to faster react-docgen
  • Updated MDX imports to use @storybook/addon-docs/blocks

Note: The @storybook/addon-mcp addon is documented but not installed by default - it requires a running dev
server and is only useful for local Mangrove development, not the static GitHub Pages build.

@khawkins98 khawkins98 changed the title feat: update to Storybook 10 feat: update to Storybook 10 + AI development features Dec 3, 2025
@khawkins98 khawkins98 requested a review from svlcek-cge January 2, 2026 10:59
@khawkins98
Copy link
Collaborator Author

@svlcek-cge I'd like to go ahead and get us on Storybook 10. As it's not clear when storybook-addon-html will merge the PR (whitespace-se/storybook-addon-html#149) to enable storybook 10 support, suggest we just disable the addon for now (have done with commit 09d2c0d ) and we can enable once it's up to date.

@khawkins98 khawkins98 merged commit 0881b27 into main Jan 4, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update to Storybook 10

2 participants