Maintenance: Drop tooling support #30940

valentinpalkovic · 2025-03-27T09:35:56Z

Closes #30353

What I did

This PR drops support for older tooling versions across Storybook packages:

Drops Vite 4 support, requiring Vite 5+ across all Vite-based frameworks and builders
Drops Angular <18 support
Drops Node.js <20 support
Drops Next.js <14.1.0 support
Updates package manager requirements (npm v10+, yarn v4+, pnpm v9+)

Migration guide entries have been added to document these changes.

Checklist for Contributors

Testing

The changes in this PR are covered in the following automated tests:

stories
unit tests
integration tests
end-to-end tests

Manual testing

This section is mandatory for all contributions. If you believe no manual test is necessary, please state so explicitly. Thanks!

Documentation

Add or update documentation reflecting your changes
If you are deprecating/removing a feature, make sure to update
MIGRATION.MD

Checklist for Maintainers

When this PR is ready for testing, make sure to add ci:normal, ci:merged or ci:daily GH label to it to run a specific set of sandboxes. The particular set of sandboxes can be found in code/lib/cli-storybook/src/sandbox-templates.ts
Make sure this PR contains one of the labels below:
Available labels
- bug: Internal changes that fixes incorrect behavior.
- maintenance: User-facing maintenance tasks.
- dependencies: Upgrading (sometimes downgrading) dependencies.
- build: Internal-facing build tooling & test updates. Will not show up in release changelog.
- cleanup: Minor cleanup style change. Will not show up in release changelog.
- documentation: Documentation only changes. Will not show up in release changelog.
- feature request: Introducing a new feature.
- BREAKING CHANGE: Changes that break compatibility in some way with current major version.
- other: Changes that don't fit in the above categories.

🦋 Canary release

This PR does not have a canary release associated. You can request a canary release of this pull request by mentioning the @storybookjs/core team here.

core team members can create a canary release here or locally with gh workflow run --repo storybookjs/storybook canary-release-pr.yml --field pr=<PR_NUMBER>

Greptile Summary

This PR implements major breaking changes for Storybook 9.0, dropping support for older tooling versions and updating minimum requirements across the ecosystem.

Raises minimum Node.js requirement to v20+ across all packages, dropping v18 support
Removes Vite 4 support, requiring Vite 5+ for all Vite-based frameworks and builders
Drops Angular <18 support and updates related dependencies
Removes several deprecated APIs including autodocs config, globals in favor of initialGlobals, and legacy button props
Updates package manager requirements to npm v10+, yarn v4+, and pnpm v9+

The changes are well documented in MIGRATION.md with clear upgrade paths provided.

….json files and update block-node-version autoblocker

… require Angular 18 and above

…te package dependencies to require Vite 5.0.0 and up across all packages

Copilot

Pull Request Overview

This PR removes legacy tooling support by dropping compatibility with older Angular versions and older Vite versions, and updating package manager requirements.

Removed support for legacy Angular options and build configurations.
Updated Vite configuration property names to align with current Vite version requirements.
Enhanced migration documentation with new package manager and framework-specific changes.

Reviewed Changes

Copilot reviewed 29 out of 44 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
code/frameworks/angular/src/types.ts	Removed the deprecated "enableNgcc" property from AngularOptions.
code/frameworks/angular/src/server/framework-preset-angular-ivy.ts	Removed ngcc-related logic and extra mainFields options for older Angular versions.
code/frameworks/angular/src/server/angular-cli-webpack.js	Removed older Angular webpack configs, now focusing on configurations for Angular 16.1+.
code/builders/builder-vite/src/vite-config.ts	Updated the Vite config environment property from "ssrBuild" to "isSsrBuild".
MIGRATION.md	Added migration notes for dropped support for Vite 4 and Angular versions below 18, and updated package manager support.

Files not reviewed (15)

code/addons/docs/package.json: Language not supported
code/builders/builder-vite/package.json: Language not supported
code/frameworks/angular/package.json: Language not supported
code/frameworks/ember/package.json: Language not supported
code/frameworks/experimental-nextjs-vite/package.json: Language not supported
code/frameworks/html-vite/package.json: Language not supported
code/frameworks/html-webpack5/package.json: Language not supported
code/frameworks/nextjs/package.json: Language not supported
code/frameworks/preact-vite/package.json: Language not supported
code/frameworks/preact-webpack5/package.json: Language not supported
code/frameworks/react-native-web-vite/package.json: Language not supported
code/frameworks/react-vite/package.json: Language not supported
code/frameworks/react-webpack5/package.json: Language not supported
code/frameworks/server-webpack5/package.json: Language not supported
code/frameworks/svelte-vite/package.json: Language not supported

github-actions · 2025-03-27T09:37:26Z

	Fails
🚫	PR is marked with "BREAKING CHANGE" label.

Generated by 🚫 dangerJS against 8c556d6

nx-cloud · 2025-03-27T09:40:45Z

View your CI Pipeline Execution ↗ for commit 8c556d6.

Command	Status	Duration	Result
`nx run-many -t build --parallel=3`	✅ Succeeded	1m 52s	View ↗

☁️ Nx Cloud last updated this comment at 2025-03-28 13:11:58 UTC

greptile-apps

LGTM

_{117 file(s) reviewed, no comment(s)}
_{Edit PR Review Bot Settings | Greptile}

…lugin>

…son and yarn.lock files

…anges in documentation and dependency requirements. Adjusted compatibility comments and removed legacy code for earlier Next.js versions.

…ngular version based on project dependencies. Removed unnecessary extraDependencies from sandbox templates.

…and update package dependencies to require Vite 5.0.0 and up across all packages" This reverts commit 9c64c48.

…te package dependencies to require Vite 5.0.0 and up across all packages

code/.storybook/main.ts

code/.storybook/preview.tsx

code/lib/cli-storybook/src/autoblock/block-dependencies-versions.ts

ndelangen · 2025-03-28T10:45:33Z

I think you may have missed a node version reference in the bin files:

storybook/code/core/bin/index.cjs

Lines 3 to 7 in 447caec

    
           const majorNodeVersion = parseInt(process.versions.node, 10); 
        
           if (majorNodeVersion < 18) { 
        
             console.error('To run Storybook you need to have Node.js 18 or higher'); 
        
             process.exit(1); 
        
           }

…gn with recent dependency requirements.

…ag for improved readability.

…torybook compatibility.

valentinpalkovic added 4 commits March 27, 2025 08:49

Update Node.js engine requirement to >=20.0.0 across multiple package…

de3473f

….json files and update block-node-version autoblocker

Add package manager support details to migration guide for Storybook 9.0

c72f021

Update Angular support in migration guide and package dependencies to…

e0fc72b

… require Angular 18 and above

Update migration guide to reflect dropped support for Vite 4 and upda…

9c64c48

…te package dependencies to require Vite 5.0.0 and up across all packages

valentinpalkovic changed the base branch from next to valentin/api-removals March 27, 2025 09:36

valentinpalkovic self-assigned this Mar 27, 2025

valentinpalkovic requested a review from Copilot March 27, 2025 09:36

Copilot AI reviewed Mar 27, 2025

View reviewed changes

valentinpalkovic added BREAKING CHANGE ci:daily Run the CI jobs that normally run in the daily job. labels Mar 27, 2025

greptile-apps bot reviewed Mar 27, 2025

View reviewed changes

valentinpalkovic added 2 commits March 27, 2025 11:30

Update externalGlobalsPlugin function signature to return a Promise<P…

9d71abd

…lugin>

Sandbox: Remove Angular 15 sandbox

b94fe01

valentinpalkovic mentioned this pull request Mar 27, 2025

[Bug]: Internal server error: Argument must be Identifier, Literal, QualifiedTypeIdentifier or TSQualifiedName. Received 'TemplateLiteral' #25155

Closed

valentinpalkovic added 5 commits March 27, 2025 11:57

Update react-docgen dependency to version 7.1.1 in multiple package.j…

bb1aff1

…son and yarn.lock files

Merge branch 'valentin/api-removals' into valentin/drop-tooling-support

6ada8ed

Merge branch 'valentin/api-removals' into valentin/drop-tooling-support

b0a444a

Removing TypeScript error suppression comments.

b23dc26

Update Next.js support to require version 14 or higher, reflecting ch…

48105b5

…anges in documentation and dependency requirements. Adjusted compatibility comments and removed legacy code for earlier Next.js versions.

valentinpalkovic added ci:merged Run the CI jobs that normally run when merged. and removed ci:daily Run the CI jobs that normally run in the daily job. labels Mar 27, 2025

valentinpalkovic added 3 commits March 27, 2025 13:31

Refactor Angular generator to dynamically set @angular-devkit/build-a…

e718ffb

…ngular version based on project dependencies. Removed unnecessary extraDependencies from sandbox templates.

Revert "Update migration guide to reflect dropped support for Vite 4 …

1ffba52

…and update package dependencies to require Vite 5.0.0 and up across all packages" This reverts commit 9c64c48.

Update migration guide to reflect dropped support for Vite 4 and upda…

d5bd25c

…te package dependencies to require Vite 5.0.0 and up across all packages

valentinpalkovic added ci:normal and removed ci:merged Run the CI jobs that normally run when merged. labels Mar 27, 2025

ndelangen reviewed Mar 28, 2025

View reviewed changes

code/.storybook/main.ts Show resolved Hide resolved

ndelangen reviewed Mar 28, 2025

View reviewed changes

code/.storybook/preview.tsx Outdated Show resolved Hide resolved

ndelangen reviewed Mar 28, 2025

View reviewed changes

code/lib/cli-storybook/src/autoblock/block-dependencies-versions.ts Show resolved Hide resolved

Base automatically changed from valentin/api-removals to next March 28, 2025 11:28

valentinpalkovic added 5 commits March 28, 2025 12:30

Update Vite version in block-dependencies-versions.ts to 5.0.0 to ali…

9a9df8b

…gn with recent dependency requirements.

Refactor StoryFn rendering in Storybook preview to use self-closing t…

36bb796

…ag for improved readability.

Update Node.js version requirement in index.cjs to 20 or higher for S…

8bced72

…torybook compatibility.

Merge branch 'next' into valentin/drop-tooling-support

dd6edc6

Fix typing issues

c5a7eb2

valentinpalkovic added ci:normal and removed ci:normal labels Mar 28, 2025

Merge branch 'next' into valentin/drop-tooling-support

8c556d6

valentinpalkovic merged commit c001e4b into next Mar 28, 2025
33 of 34 checks passed

valentinpalkovic deleted the valentin/drop-tooling-support branch March 28, 2025 15:15

github-actions bot mentioned this pull request Mar 28, 2025

Release: Prerelease 9.0.0-alpha.12 #30943

Merged

16 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Maintenance: Drop tooling support #30940

Maintenance: Drop tooling support #30940

Uh oh!

valentinpalkovic commented Mar 27, 2025 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

github-actions bot commented Mar 27, 2025 •

edited

Loading

Uh oh!

nx-cloud bot commented Mar 27, 2025 •

edited

Loading

Uh oh!

greptile-apps bot left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ndelangen commented Mar 28, 2025

Uh oh!

Uh oh!

Uh oh!

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Uh oh!

Maintenance: Drop tooling support #30940

Maintenance: Drop tooling support #30940

Uh oh!

Conversation

valentinpalkovic commented Mar 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What I did

Checklist for Contributors

Testing

The changes in this PR are covered in the following automated tests:

Manual testing

Documentation

Checklist for Maintainers

🦋 Canary release

Greptile Summary

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

github-actions bot commented Mar 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nx-cloud bot commented Mar 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

greptile-apps bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ndelangen commented Mar 28, 2025

Uh oh!

Uh oh!

Uh oh!

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

valentinpalkovic commented Mar 27, 2025 •

edited

Loading

github-actions bot commented Mar 27, 2025 •

edited

Loading

nx-cloud bot commented Mar 27, 2025 •

edited

Loading