Skip to content

build: upgrade Storybook 8.6.x to latest 10.x (aligned stack) #768

Description

@fpigeonjr

What to build

The Storybook dev server currently prints an upgrade notice on startup:

A new version (10.5.2) is available!
Upgrade now: npx storybook@latest upgrade

The repo is pinned to the Storybook 8.6.x stack. This ticket is to evaluate and perform the upgrade to the latest 10.x line, keeping the entire @storybook/* toolchain on a single aligned major version, and verifying the static build and Playwright regression suite still pass.

Important context / caveats

  • The whole stack must be aligned. In Bump the npm-dependencies group with 24 updates #752 the upgrade broke with ERR_UNSUPPORTED_DIR_IMPORT because @storybook/html-webpack5 had no release matching the other packages' major. Before bumping, confirm @storybook/html-webpack5 (and every other @storybook/* dep) has a matching 10.x release.
  • Current pinned packages (from package.json): storybook, @storybook/html, @storybook/html-webpack5, @storybook/addon-actions/-essentials/-interactions/-links, @storybook/preset-scss, @storybook/testing-library, @whitespace/storybook-addon-html. Some third-party addons may not yet support Storybook 10 — check compatibility and find replacements or drop them if unmaintained.
  • The build currently emits @storybook/components "export not found" WARNings — pre-existing Storybook 7→8 internal-API deprecations. A 10.x upgrade may clear these or surface new ones; note any changes.
  • CI sets NODE_OPTIONS="--max_old_space_size=8192" for the build; keep this in place unless the new version reduces heap pressure.

Acceptance criteria

  • All @storybook/* and storybook dependencies aligned on a single latest 10.x version in package.json (no mixed majors)
  • npm run build:storybook produces _site/index.html and exits 0
  • npm run test:storybook — all existing Playwright regression tests pass against the new build
  • npm start (dev server on 6006) launches without the "new version available" notice
  • Any removed/replaced incompatible addons documented in the PR description
  • Startup/build warning changes (cleared or new) noted in the PR description

Blocked by

None - can start immediately

Metadata

Metadata

Assignees

No one assigned

    Labels

    buildtech-debtTechnical debt / cleanup work

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions