npm / @storybook/addon-docs
@storybook/addon-docs
What changed in @storybook/addon-docs 9 to 10, from its official release notes, upgrade guides and advisories. Also covers @storybook/addon-a11y, @storybook/react-webpack5, eslint-plugin-storybook. Sources checked 2026-10-18.
11 breaking3 security3 deprecations27 new APIs and options1 performance13 behavior and defaults31 tooling83 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@storybook/addon-docs 10165 changes
Breaking changes 11
The tools command now defaults to attach mode.
Component manifests are disabled by default. If you use the MCP addon, upgrade it to version 0.5.0 or later to keep the docs toolset in the MCP server.
Refs are now updated sequentially in experimental_setFilter.
Websocket connections now require a token.
Browser opening now honors BROWSER shell scripts before falling back to xdg-open.
The globalTypes types are now more strict.
The zoom tool was reimplemented, adds zoom level 8, limits manual input to 800%, and supports a keyboard shortcut for the plus key.
Removes REACT_PROJECT as a CLI projectType.
The preview enforces an inert body when the manager is focus-trapped.
The dynamic-CWD globbing change was reverted, changing how Storybook resolves glob patterns.
Storybook now ships only ESM, removing CommonJS bundles; this simplifies distribution and reduces install size by 29%.
Security 3
Patches GHSA-f2ph-cmg5-wxc8 and GHSA-px85-f4q5-jh77.
Updates the default allowed hosts in host validation middleware.
Adds host and origin validation to requests and websocket connections.
Deprecations 3
Storybook warns when the legacy defaultViewport parameter is used.
ExternalDocs is deprecated.
PnP support is marked as deprecated.
New APIs and options 26
Fetches static open-service snapshots relative to the document.
An experimental React docgen service provides unified component metadata across MCP, Docs, and Controls.
Adds an experimental feature flag for Agentic Review, which provides AI-curated visual changesets and search results.
The Meta component accepts an explicit id prop for standalone MDX.
Story and meta annotations now allow partial globals overrides.
Supports resolving subcomponents attached as properties of a parent component.
Adds a feature flag for change detection.
Component manifests now include subcomponents.
The sidebar can filter stories by status, supporting review of changes and test results.
Adds status values for new, modified, and affected stories.
The Vitest addon adds a channel API for programmatically triggering test runs.
The option is renamed from experimentalComponentsManifest and defaults to true.
The Actions parameter adds expandLevel to configure the tree depth.
Canvas block parameters now support sourceState: 'none'.
Storybook MCP is available as a preview release for React, enabling agentic component development, documentation, and testing.
The ThemesGlobals interface declaration is now exported.
Adds Vike metadata frameworks.
The Checklist widget can now be disabled through feature config.
A manager API for getting story URLs was added.
A disable parameter was added for the interactions panel.
A new exported function lets developers access the preferred color scheme.
React gains experimental component manifest generation, providing component information for Storybook MCP.
React adds a components page for the experimental component manifest feature.
Adds range validation to Number Control.
Typesafe CSF factories are available as a Preview for React.
Tag filtering gains exclusion and configuration options for managing the sidebar.
Performance 1
Module-mocking plugins have improved performance.
Behavior and default changes 13
TypeScript's JSDoc semantics are now canonical for component docgen.
Boolean props set to false are now rendered in source snippets.
Framework detection now supports peerDependencies for component libraries.
Filter state is persisted in the URL, and the initial story selection respects active filters.
Story-level argTypes can override control: false set in meta.
Prioritizes story viewport globals and avoids user-global pollution.
Postinstall setup is skipped when configured, allowing developers to control whether the Vitest addon runs setup after installation.
Storybook invalidates its cache when the Storybook version is upgraded.
Composition handles 401 responses using loginUrl from Chromatic.
The vision simulator state is tracked through globals and its styles are applied in the preview.
Enhances getPrettier to provide a Prettier interface.
Drops some restrictions on completing the checklist.
CSF-strict ESLint rules now apply only to story files.
Tooling 30
The CLI adds the skills command for agent tools and skills workflows.
The CLI adds a public tools command derived at runtime from the OSA toolsets.
AI setup instructions now use msw-storybook-addon v3.
Storybook detects Git changes to support change-aware story review.
React component metadata extraction uses a Volar-style LanguageService, improving component documentation generation.
Adds a tsconfig fallback chain and a warning for monorepos.
The CLI prompts about init crash reports.
Addon-Vitest streamlines Vite config detection during init and postinstall.
Storybook supports ESLint 10.
React adds react-docgen-typescript to the component manifest.
Vitest setup no longer requires a dedicated setup file, simplifying configuration.
Adds support for Next.js v16.2.
The CLI sets the STORYBOOK environment variable.
The codemod now fixes cross-file story imports.
The CLI supports Vitest addon setup when installation is skipped.
The Vitest addon supports Vite or Vitest configuration with a deferred export.
The codemod now works with preview files that have no exports.
The CSF factories codemod adds non-interactive mode and a --glob flag for selecting files.
The codemod preserves leading comments when adding imports.
Addon-Vitest automigration now normalizes Windows paths.
The Vitest plugin configuration disables requireAssertions for expect.
Addon Vitest supports a simple vite.config that does not use the defineConfig helper.
Added init telemetry for CLI integrations.
Public API types now support TypeScript's exactOptionalPropertyTypes option.
The component transformer now supports wrapped components.
The CLI has a new init workflow, Clack UI, and Generator System for faster, more reliable installation.
Adds Preact support to the Vitest addon.
Module automocking is introduced to make testing easier.
Storybook adds an open-in-editor feature.
Storybook adds test syntax for Storybook v10.
Fixes and other changes 78
Fixes hidden output from CLI commands when using Yarn 1.
The enhanceArgTypes function is now explicitly typed.
Fixes a build crash when the ref reachability check fails mid-request.
Restores the change-detection CTA in the sidebar.
Fixes Vitest ERESOLVE errors when using the CLI on fresh Next.js apps.
Webpack 5 now uses strict mtime equality when reusing the mock cache.
Null union members are included as enum options when TypeScript argTypes are converted.
Preserves discriminated union prop values during metadata extraction.
Bundles CSF helpers so the plugin loads without Storybook.
Keeps tsconfig path aliases working on solution-style tsconfigs.
Preview output filenames are prevented from becoming too long.
Pseudo-states rewriting now handles nested functional selectors correctly.
Stylesheet rewrites are now WebKit-safe.
Fixed a crash when initializing UrlStore on a docs path.
Fixed the dark mode mismatch in SyntaxHighlighter.
Measure & Outline now honors the disable parameter.
Fixes the layout.showPanel configuration.
Fixes React subcomponent prop extraction when the component is not used in JSX.
The lazy-compilation import pipeline is gated on the webpack version.
Prevents core annotations from being injected twice into mixed CSF3+4 stories.
Telemetry event-log POST requests now have a timeout to prevent builds from hanging.
The sidebar now respects the !dev tag on MDX docs.
Docs pages no longer reset scroll position on HMR re-render.
Primary and Controls blocks now render in custom MDX pages.
Fixed CSF parsing of string literal export names.
Fixed command resolution on Windows when using non-Node package managers.
Fixed global background and color styles affecting stories.
Packages that publish React-based declarations now add optional React type peers.
Already transformed config files are no longer re-processed for CSF factories.
Fixes duplicate preview loading in Vitest.
React-docgen tries a .tsx fallback when resolving .js ESM imports.
Fixes the WebSocket connection for StackBlitz/WebContainers.
A story-local viewport no longer persists in the URL.
Overrides of docs.components are restored for doc blocks.
Fixes error reporting in ManagerErrorBoundary.
Storybook correctly falls back to the first detected Vitest config file.
Resolves the builder preset path correctly in pnpm strict mode.
Fixes a false ConfigFile parser warning for a
definePreview({...}).type<T>()export default.Fixed Storybook failing to load iframe.html when publishing.
Manifest snippet generation now handles the render identifier.
Prevented crashes when tag filters contain undefined entries.
Avoids hanging when inferring args for recursive calls on DOM elements.
Addon Pseudo-states now processes all nested CSS rules.
Inputs are sanitized when saving from controls.
Fixes empty manifest stories when a React meta has no explicit title.
Manifests now use the correct story name.
The dynamicTitle: false setting now works for user-defined tools.
npmlog output now honors the --loglevel setting.
Rendering of View Transitions is fixed in Firefox.
Glob pattern handling is fixed on Windows.
The CSF factory detection no longer falsely identifies Zod v4 .meta() as a CSF Factory.
The codemod no longer fails when filenames are quoted.
Aliasing AppRouterContext to the shared runtime fixes Link navigation.
Fixes previewHref when the current path does not end with a slash.
The Storybook project is appended to an existing test.projects array without double nesting.
Fixed a resolution issue for @vitest/mocker in Builder-Webpack5.
React docgen extraction and story creation support were fixed.
The Viewports tool was redesigned, with viewport UX fixes and handling fixes for viewport args and their reset option.
Fixes several CSF factory bugs.
Fixes React error 300 on some addons.
Fixes parsing of .env files.
Fixes a missing await in automigration.
Excludes open from pre-bundling so local xdg-open can be reached.
The settings page no longer displays shortcuts that do not exist.
Fixes a keyboard navigation bug for the reset option in Select.
Fixes how checklist state changes are reported.
React adds experimental code examples with improved JSX snippets.
Storybook’s UI received accessibility improvements, including fixes for hundreds of accessibility issues.
Fixes the CSF export interface declaration for NextPreview.
Fixes the export interface declaration for ReactMeta.
Added a reentry guard to the focus patch.
Fixes
modulebeing undefined in ESM when using CRA.Fixes an issue with running Storybook after it has been initialized.
Core handles TypeScript satisfies/as syntaxes better.
A wrong import was fixed to support Yarn PnP.
Fixes glob string formatting in the codemod.
Improves file path resolution on Windows.
Incorrect imports in presets were fixed.
@storybook/addon-docs 97 changes
New APIs and options 1
Adds the experimental_devServer preset.
Tooling 1
Improves the automigration for viewport and backgrounds.
Fixes and other changes 5
Fixes Next.js project creation in empty directories.
Adds telemetry for the first preview load.
Fixed the play-fn tag for methods.
Fixes missing Next.js declaration files, which could affect TypeScript users of the package.
Fixes
sb.mockusage in deployed Storybooks served from subpaths.