Getting started
Storybook versions
The main branch ships the Storybook v9 Rsbuild builder together with each framework integration. Use the table below to match your Storybook version, and review the official migration guide before moving to v9.
| Storybook | Storybook Rsbuild |
|---|---|
| v9 | ^2.0.0 |
| v8 | ^1.0.0 |
| Package | What it provides |
|---|---|
| storybook-builder-rsbuild | The Rsbuild-powered Storybook builder |
| storybook-react-rsbuild | React framework integration configured for Rsbuild |
| storybook-vue3-rsbuild | Vue 3 framework integration configured for Rsbuild |
| storybook-html-rsbuild | Vanilla JavaScript/TypeScript integration |
| storybook-web-components-rsbuild | Lit and Web Components integration |
| storybook-addon-rslib | Addon that reuses Rslib configuration inside Storybook |
Usage
Peer dependency requirements
@rsbuild/core >= 1.0.1— Storybook Rsbuild depends on the stable Rsbuild 1.0 runtime. See the 1.0 release announcement for background.storybook >= 9.0.0— The packages are validated against Storybook 9. Upgrade guidance is available in the Storybook release notes.
When using the v8-compatible packages, you do not install storybook-builder-rsbuild directly. Framework packages such as storybook-react-rsbuild and storybook-vue3-rsbuild include it for you.
Use the following framework guides to plug Storybook Rsbuild into your project.
Use with frameworks
React
Vue
See integrating with Vue.
Vanilla JS/TS
See integrating with vanilla JavaScript / TypeScript.
Web components
See integrating with web components (Lit).
Integration
With Rslib
Reuse your existing Rslib configuration inside Storybook.
With Rspack
Connect Storybook Rsbuild to an existing Rspack setup.