Compatibility Tracker with JS Ecosystem Tools

[valentinpalkovic]

This document serves as a comprehensive tracker of various ecosystems related to Storybook including package managers, renderers, and builders. The goal is to track the release dates, version numbers, and the compatibility status of these ecosystems with Storybook. It provides a streamlined view to monitor and manage any potential dependencies or breaking changes and help maintain the stability of Storybook.

Operating Systems

Operating System	Core Storybook Support
Windows + WSL	✅
macOS	✅
Linux	✅

Javascript Engines

Javascript Engines	Version Number	Release Date	EOL	Core Storybook Support	Drop Support
Node.js	v18	2022-04-19	2025-04-30	✅	Storybook 9
	v20	2023-04-18	2026-04-30	✅	-
	v22	2024-04-24	2027-04-30	✅	-
	v24	2024-05-06	2028-04-30	🔜 see #31434	-
Bun				⚠️	-
Deno				❌	-

Package Managers

Package Manager	Version Number	Release Date	EOL	Core Storybook Support	Drop Support Date
npm	v8	2021-10-07	-	✅	Storybook 9
	v9	2022-10-24	-	✅	Storybook 9
	v10	2023-08-31	-		-
yarn (berry) + pnp	v3	2021-08-06	-	✅	-
	v4	2023-10-23	-	✅	-
pnpm + pnp	v7	2022-05-01	unmaintained	✅	-
	v8	2023-03-27	-	✅	-
	v9	2024-04-16	-	✅	-
bun	v1	2023-09-08	-	⚠️	-

Renderers

Renderer	Version Number	Release Date	EOL	Core Storybook Support	Drop official Support
React	v16	2020-10-14	-	✅
	v17	2021-03-22	-	✅
	v18	2022-06-14	-	✅
	v19	2024-04-25		✅
Angular	v15	2022-11-22	2024-05-24	✅	Storybook 9
	v16	2023-07-24	2024-11-08	✅	Storybook 9
	v17	2023-11-06	2025-05-15	✅	Storybook 9
	v18	2024-05-22	-	✅
	v19	2024-11-19	-	✅
Vue	v3	2022-05-11	-	✅
	v4	unknown	-	-
Svelte	v4	2023-06-09	-	✅	Storybook 9
	v5	2024-10-22	-	✅
Lit	v2	2023-06-02	-	✅
	v3	2023-10-10	-	✅

Builders

Builder	Version Number	Release Date	EOL	Core Storybook Support	Drop official Support
Webpack	v5	2020-10-10	-	✅
	v6	unknown	-	-
Vite	v4	2022-12-09	-	✅	Storybook 9
	v5	2023-11-16	-	✅
	v6	2024-11-26	-	✅
Esbuild				❌
Turbopack				❌
rspack				🧑🏼‍🤝‍🧑🏼 (link)
parcel				🧑🏼‍🤝‍🧑🏼 (link)

Legend:

• ✅ - supported and maintained
• 🔜 - support planned
• ⚠️ - experimental -- mostly functional but with limitation
• 🧑🏼‍🤝‍🧑🏼 - supported by community
• ❌ - not supported

[lanesawyer]

It would be nice to get Parcel listed in the bundler section for tracking. It's big enough that React recommends it or Vite as a tool to reach for if you're not using a framework.

[cgcompassion]

Has there been any discussion on adding support for bun?

[valentinpalkovic]

Adding official support for another Javascript runtime besides Node.js would mean we had to commit long-term supporting a runtime like bun. Currently, we are still waiting for a broader adoption of bun to satisfy official support since we have to juggle with the limited resources we have and use them wisely.

On the other hand, I have already seen posts and mentions, that bun seems to work with Storybook, at least in some circumstances.

If you want to drive and accelerate Storybook's support of Bun, I would suggest creating an RFC or even just a plain Issue where we can track missing pieces which are required fully supporting bun. Then other contributors might participate, and supporting Bun might be driven by the community in the first place.

[Minniehajj]

Adding official support for another Javascript runtime besides Node.js would mean we had to commit long-term supporting a runtime like bun. Currently, we are still waiting for a broader adoption of bun to satisfy official support since we have to juggle with the limited resources we have and use them wisely.

On the other hand, I have already seen posts and mentions, that bun seems to work with Storybook, at least in some circumstances.

If you want to drive and accelerate Storybook's support of Bun, I would suggest creating an RFC or even just a plain Issue where we can track missing pieces which are required fully supporting bun. Then other contributors might participate, and supporting Bun might be driven by the community in the first place.

How about allowing for the package manager option for bun since it not only is a runtime, but a package manager as well.