@storybook/addon-docs

Improved UI and story authoring ergonomics

Storybook 10.2 contains hundreds of fixes and improvement including:

• 💅 New Viewports and Zoom UI

• 🏭 Typesafe CSF factories for Vue, Angular, Web Components (preview)

• 📄 MDX support for Storybook MCP (experimental)

List of all updates

• Addon-A11y: Lock vision filter dropdown for stories with vision global

• Addon-Docs: Add MDX manifest generation

• Addon-Docs: Skip !autodocs stories when computing primary story

• Addon-Pseudo States: Fix stylesheet rewrite for :not() with parenthesis in inner selector

• Addon-Vitest: Added timeout for fetching localhost 6006 during global setup.

• Addon-Vitest: Fallback detecting vitest version in postinstall

• Addon-Vitest: Improve error message in testing widget modal

• Addon-Vitest: Improve perf & fix loading incorrect .env file

• CLI: Detect free port when running dev during initiate

• CLI: Remove any return type of getAbsolutePath

• CLI: Skip vitest transform for CSF Factories in a11y-addon-test automigration

• Codemod: Fix glob string to only match stories files

• Controls: Allow resetting the Select control

• Controls: Fix displaying as object instead of select for optional union types

• Controls: Force object control JSON mode to reset

• Core and Vite: Use story index as source of truth for Vite paths

• Core: Add getStoryHrefs manager API and add hotkey for "open in isolation"

• Core: Add global error boundary for Manager UI

• Core: Add support for wrapped components in component transformer

• Core: Add try-catch for cross-origin access in Storybook hooks

• Core: Add zoom level 8 and limit manual input to 800%

• Core: Avoid late layout shift and improve ChecklistWidget perceived performance

• Core: Ensure /project.json route is up before builders serve local FS

• Core: Fix react-docgen-typescript support in story creation

• Core: Fix Checklist behavior with hidden sidebar

• Core: Fix cwd handling for negated globs

• Core: Fix Date input layout

• Core: Fix import statement for react-docgen-typescript

• Core: Fix input width

• Core: Fix manual zoom input field UX

• Core: Fix onboarding visual bugs, survey telemetry and modal dismissal

• Core: Fix play function mount detection when destructuring in the function body

• Core: Fix viewport args handling and reset option

• Core: Honor BROWSER shell scripts before xdg-open

• Core: Improve addon sanitization

• Core: Improve path handling in arg types data extraction

• Core: Improve the story generation experience

• Core: Redesign and refactor Viewports tool

• Core: Refactor channel initialization

• Core: Render sidebar toggle on settings pages

• Core: Retry writeFile cache when EBUSY error occurs

• Core: Support defineConfig when setting up ESLint plugin

• Core: Support disabling Checklist widget through feature config

• Core: Track vision simulator state through globals and apply styles in preview

• Core: Use canonical links in sidebar and menu

• Core: Viewport UX fixes

• Core: Zoom tool reimplementation

• CSF-Factories: Add CSF Factories for Vue3, Web Components, and Angular

• CSF-Factories: Allow kebab-case HTML attribute names in web components args

• CSF-Factories: Export WebComponentsTypes and VueTypes

• CSF-Factories: Skip non-factory exports instead of throwing error

• CSF: Export type to prevent type cannot be named-errors

• Dependencies: Bump various packages

• Dependencies: Update baseline-browser-mapping

• Docgen: Update extraction of React docgen

• Docs-Blocks: Fix broken tooltip in ArgValue details

• Interactions: Add disable parameter for interactions panel

• Interactions: Fix state reset bug when switching stories with date mocks

• Manager: Ensure reset item only appears in globals toolbar when specified

• Manager: Fix system query parameters being overridable

• Manifests: Add support for summaries in MDX files

• Manifests: Refactor from componentManifestGenerator to extensible manifests preset property

• Manifests: Support !manifest tag in preview files

• NextJS: Import next/dist with .js-extension for ESM compat

• NextJS: Support top-level weight/style in next/font/local with string src

• NextJSVite: Add @opentelemetry/api to optimizeDeps

• NextJSVite: Upgrade plugin

• Onboarding: Fix navigation to first story when configure-your-project entry missing

• Onboarding: Hide TourGuide as soon as tests start

• Preview: Prevent error in RN due to navigator?.clipboard

• Preview: Treat canceled animations as finished

• React: Use self-closing tag for code snippets

• SvelteKit: Align JS template with TS template

• Telemetry: Add packageJson.type

• TypeScript: Fix summary undefined type issue

• TypeScript: Improve globalTypes type-strictness

• TypeScript: Reduce cannot be named errors

• TypeScript: Support exactOptionalPropertyTypes for public API types

• UI: Ensure consistent right padding in TreeNode

• UI: Ensure preview error displays use a readable text color

• UI: Fix border color for Select picker

• UI: Fix empty sidebar after navigating from search

• UI: Fix regression in select close handler focus

• UI: Fix search highlight visibility in High Contrast Mode

• UI: Improve landmark navigation

• UI: Keep preview frame stable in overall layout

• UI: Make vertical alignment of TestStatusIcon more robust

• UI: Prevent primary story from duplicating anchor ID

• UI: Prevent updating non-existent stories in sidebar

• Upgrade: Preserve package.json indentation when upgrading

• Vue3: Update renderer's setup function to allow passing generic HostElement type

• Webpack: Revert "disable bugfixes property in swc and babel

• Zoom: Keyboard-shortcut for the plus key

Easier to setup, more accessible to use

Storybook 10.1 focuses on two key improvements: installation and accessibility:

• ♿ UI overhaul to fix hundreds of a11y issues

• 🧑‍💻 CLI overhaul for faster, more reliable install

• ✅ Checklist-based onboarding guide for new users

The release also contains compatibility fixes for:

• 🅰️ Angular 21 support

• 🦀 RSbuild install support in CLI

• ⚡️ Preact support for Vitest addon

Finally, it contains two highly-requested experimental features:

• 📋 Component manifest for Storybook MCP

• ⚛️ Improved JSX code snippets for React

List of all updates

• A11y: Add aria-selected attribute to tab buttons

• A11y: Make search clear button keyboard accessible

• Addon-Vitest: Ensure Storybook starts correctly across platforms by using shell in spawn

• Angular: Add preset entry point for framework

• Angular: Add support for v21

• Angular: Don't kill dev command by using observables

• Angular: Migrate from RxJS to async/await in command builders and run Compodoc utility as spinner

• Angular: Replace deprecated import of ApplicationConfig

• Automigration: Update description and link for addon-a11y-addon-test

• Checklist: Autocomplete "See what's new" on URL navigation

• Checklist: Data improvements

• CLI: Change yarn package manager value to yarn1

• CLI: Fix 'beforeVersion' evaluation for Storybook package

• CLI: Fix access to getOptionValue in postAction hook

• CLI: Fix framework config validation path and messages

• CLI: Fix passing flags for bun users during init

• CLI: Fix Vitest v3 installs and refactor AddonVitestService; align create‑storybook usage

• CLI: In csf-factories codemod only remove types which are unused

• CLI: Minor improvements

• CLI: Modernize Storybook CLI with new init workflow, Clack UI, and Generator System

• CLI: Standardize debug log messages across the application

• CLI: Update clack

• CLI: Update compatibility guidance link in summary message

• CLI: Update postAction hook to use command parameter for logfile retrieval

• CLI: Update upgrade message

• Core: Fix getDocsUrl for canary versions

• Core: Fix testing widget focus outline

• Core: Improve globbing using dynamic CWD

• Core: Rename Listbox component to ActionList and use it in TagsFilterPanel

• Core: Significantly improve Storybook's own accessibility

• Core: Update getDocsUrl to add a default ref param and set guide as ref for links in the Guide

• Guide: Collapse checklist items by default

• Guide: Hide items for which their required feature is disabled (controls, viewport, interactions)

• Maintenance: Enable syntax minification for dead code elimination

• Manager: Added tokens and a dark color scheme for status colors

• Middleware: Prepend file:// to middleware import for Windows support

• Onboarding: Guided tour checklist

• React: Add isPackage flag to component imports for better package identification

• React: Add manifests/components.html page

• React: Change examples to stories in manifests and show correct examples and prop types

• React: Experimental code examples

• React: Implement manifests/component.json for React

• React: Improve automatic component, automatic imports, support barrel files and enhance story filtering

• React: Improve error handling of component manifest generation

• React: Improve error messages in component manifest

• React: Improve import rewriting when tsconfig paths are used

• Remove yarn esbuild pnp plugin

• Theming: Set themes.normal according to user preference and export getPreferredColorScheme

• UI: Add padding for ArgsTable shadow in TabbedArgsTable

• UI: Add VRTs to FileSearchModal in light theme

• UI: Fix crashes in Select when passed falsy non-string options

• UI: Fix regression on addon panel empty content fontsize

• UI: Fix trivial RefBlocks ARIA violations

• UI: Improve status handling in sidebar nodes

• UI: Increase border contrast of Checkbox, Radio, and Range

• UI: Refocus search input after clearing it

• UI: Rework default background of Color swatch for dark mode

• Upgrade: Satellite compatible with 10.1 prerelease

Storybook 10 contains one breaking change: it’s ESM-only. This simplifies our distribution and reduces install size by 29% while simultaneously unminifying dist code for easier debugging. It also includes features to level up your UI development, documentation, and testing workflows:

• 🧩 Module automocking for easier testing

• 🏭 Typesafe CSF factories Preview for React

• 💫 UI editing and sharing optimizations

• 🏷️ Tag filtering exclusion and configuration for sidebar management

• 🔀 Next 16, Vitest 4, Svelte async components, and more!

List of all updates

• A11Y: Bugfix missing manager.js entry-file

• A11y: Persist tab/highlight across docs navigation

• Addon A11y: Prevent setting highlights for old results

• Addon Docs: Fix Symbol conversion issue in docs page and controls panel

• Addon Vitest: Fix incorrect file modifications during setup

• Addon Vitest: Support modifying mergeConfig on addon setup

• Addon-docs: Add eject button to canvas toolbar

• AddonA11Y: Fix postinstall

• AddonViewport: Stricter types

• Angular: Add fileURLToPath for preview annotation paths

• Angular: Fix entry.polyfills undefined error

• Angular: Inherit options from browserTarget

• AutoMigration: Fix sb10 migration when main config contains require

• Cleanup: Remove duplicated entrypoints in core

• CLI: Add addon-console automigration

• CLI: Avoid mixed CSF in files with unconventional stories

• CLI: Change message in downgrade-blocker

• CLI: CSF factories codemod - support annotations in npx context

• CLI: Fix CSF factories addon syncing in storybook add command

• CLI: Fix throwing in readonly environments

• CLI: Init not running dev when it should fixed

• CLI: Make relative imports default in csf-factories codemod

• CLI: Switch over to modern-tar

• Codemod: Replace globby with tinyglobby

• Controls: Allow primitive values of ReactNode argType

• Controls: Fix adding new values to arrays

• Core: Add "open in editor" feature

• Core: Add parameter typings for addon-pseudo-state

• Core: Dedupe aria-query and @testing-library/dom packages

• Core: Enhance warning for Testing Library's screen usage in docs mode

• Core: Ensure valid QR code URL

• Core: Fix external-globals-plugin handle undefined cache dir

• Core: Fix Node 24 deprecation warning

• Core: Fix staticCopy not copying index.html to sub directory

• Core: Fix stepping back through story interactions panel

• Core: Improve addon detection in automigrations on windows

• Core: Improve es-toolkit usage for better tree-shaking

• Core: Join framework preset path with slash

• Core: Make subtype an optional property on an index input

• deprecated

  Core: Mark pnp support as deprecated

• Core: Prevent BAIL state from showing in interactions panel when switching stories

• Core: Prevent navigating to hidden (filtered) item

• Core: Remove CJS bundles, only ship ESM

• Core: Replace es-toolkit compat imports with non-compat

• Core: Switch from mlly to exsolve

• Core: Update tags filter UI

• Core: Use exsolve resolveModulePath for safeResolveModule

• Core: Various QA fixes

• CoreServer: Fix Arc can't get every window

• CSF: Add Storybook test syntax (Storybook v10)

• CSF: Enhance config-to-csf-factory to support type wrappers

• Dts: Ensure .tsx files emit .d.ts type files

• Allow proceeding without selecting automigrations in upgrade command

• ESLint plugin homepage URL updates

• Incorrect URLS for the upgrade command

• Maintenance: Fix bundle size bloat caused by SyntaxHighlighter (createElement)

• Maintenance: Hotfix for missing nextjs dts files, thanks @ndelangen!

• removed

  Maintenance: Remove globalization for dropped entrypoints

• Mock: Catch errors when transforming preview files

• Modernize: Replace fs-extra with native APIs

• Move: Addon jest into it's own repository

• Next.js-vite: Use fileURLToPath for module resolution in preset

• Next.js: Avoid multiple webpack versions at runtime

• Next.js: Remove next/config usage in Next.js >=v16 projects

• Next.js: Return mocked router instead of actual router in useRouter

• Nextjs: Fix config access for Vite

• Nextjs: Fix Nextjs version detection with prereleases

• Onboarding: Prevent confetti overlay from intercepting pointer events

• Onboarding: Tweak referral wording in survey

• PreactVite: Add node entry point

• Presets: Support extensionless imports in TS-based presets

• React Native: Fix document reference error in open-in-editor

• React: Simplify version detection

• Replace: Use empathic over find-up

• Svelte: Improve support for async components

• Svelte: Simplify public types - use modern Component

• SvelteKit: Add support for mocking $app/state

• SvelteKit: Fix set_context_after_init error when experimental async is enabled

• Tags: Remove undocumented x-only tags

• Telemetry: Improve dev cancellation handling

• Telemetry: Send index stats on dev exit

• UI: Allow showing or hiding the addon panel

• UI: Improve sidebar empty state

• UI: Improve syntax-highlighter bundling

• Update: Satellite repos after major version bump

• Upgrade: Enhance ESM compatibility checks and banner generation

• Upgrade: Packages open

• Upgrades: Packages boxen commander giget

• Vite: Optimize @storybook/addon-docs/blocks dependency