You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The key issue is that Storybook 8 removed support for .stories.mdx files (the hybrid format where stories are defined inside MDX). Stories must now be in CSF (Component Story Format) .stories.js files, with MDX used only for documentation.
What We Did
Ran the upgrade command:
npx storybook@8 upgrade
This updates packages and runs automigrations including the mdx-to-csf codemod.
The codemod converted all 21 .stories.mdx files to:
.stories.js files (CSF3 format with story definitions)
.mdx files (pure documentation)
Added required addons:
@storybook/addon-webpack5-compiler-swc - compiler support for Storybook 8
@storybook/addon-mdx-gfm - GitHub-flavored markdown support (migration helper)
Updated configuration:
Removed deprecated argTypesRegex from preview.js
Updated stories glob pattern in main.js
Verified the build passes:npm run build-storybook completes successfully.
Activity
melvincarvalho commentedon Jan 18, 2026
Saw the "help wanted" tag and took a look at this.
Storybook Migration Resources
The official documentation for upgrading:
The key issue is that Storybook 8 removed support for
.stories.mdxfiles (the hybrid format where stories are defined inside MDX). Stories must now be in CSF (Component Story Format).stories.jsfiles, with MDX used only for documentation.What We Did
Ran the upgrade command:
This updates packages and runs automigrations including the
mdx-to-csfcodemod.The codemod converted all 21
.stories.mdxfiles to:.stories.jsfiles (CSF3 format with story definitions).mdxfiles (pure documentation)Added required addons:
@storybook/addon-webpack5-compiler-swc- compiler support for Storybook 8@storybook/addon-mdx-gfm- GitHub-flavored markdown support (migration helper)Updated configuration:
argTypesRegexfrom preview.jsVerified the build passes:
npm run build-storybookcompletes successfully.Commit: f1e8f9f
Upgrade Storybook from 7.6.20 to 8.6.15