npm / chromatic
chromatic
What changed in chromatic 13 to 18, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
6 breaking1 security13 new APIs and options24 behavior and defaults11 tooling53 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initchromatic 1855 changes
New APIs and options 6
TurboSnap v2 supports the --externals option.
TurboSnap v2 supports the --untraced option.
A subcommand was added to generate a TurboSnap v2 manifest.
Chromatic supports CHROMATIC_DISABLE_TELEMETRY for controlling telemetry.
Chromatic supports DO_NOT_TRACK for controlling telemetry.
Adds a --help command-line parameter for publishAction.
Behavior and default changes 9
TurboSnap v2 applies gitignore values from sibling packages in monorepos.
TurboSnap v2 skips gitignored files in the Storybook config directory.
TurboSnap v2 skips files that Git ignores.
TurboSnap v2 hashes are always uploaded when using Chromatic.
Sets component owners when present.
Paths in ctx.storybook are resolved to absolute paths.
Storybook main config parsing is improved.
TurboSnap status changes from “Skipped” to “Bypassed.”
CLI task lists and task output now render with Clack, changing the command-line presentation.
Tooling 7
Chromatic communicates the number of ignored tests.
Chromatic parses PNPM lock files and supports PNPM workspaces.
TurboSnap v2 is released and runs alongside v1.
Chromatic supports installing dependencies with pnpm.
TurboSnap v2 adds story detection.
TurboSnap v2 adds Storybook version detection.
Diagnostics and debug logging include more git info for ancestor calculation.
Fixes and other changes 33
Fixes parsing of Azure DevOps slugs.
Removes the alpha warning from React Native builds.
Lists untracked files relative to the repository root.
Adds ADO provider support.
Uses a generic speedUpCI message.
Single-file staticDirs entries are hashed in the TurboSnap v2 manifest.
Hash collection is skipped when TurboSnap is explicitly disabled.
Users are advised when the Storybook config directory is invalid.
Fixes parsing of PNPM 12 multi-document lockfiles.
TurboSnap v1 runs when no files have changed.
Chromatic now follows committed symlinks when checking out baseline lockfiles.
Users are advised when TurboSnap v2 runs without dependencies.
Storybook resolution paths are logged.
TurboSnap v2 context is added to Sentry.
Globals are determined by their imports, fixing how Chromatic identifies globals.
Chromatic reads the Storybook version from the config directory first, then falls back to the previous lookup.
ENAMETOOLONG errors are now ignored.
Webpack escape characters are stripped from file paths.
Build failures during Vitest runs no longer reference Storybook, making the error output relevant to the test run.
TurboSnap errors in Vitest runs are now more descriptive, helping developers understand failures.
TurboSnap v2 now filters data URLs.
Sentry tags are now added to TurboSnap v2 events, making those events easier to identify.
Resolves the correct E2E package when multiple packages are installed.
Capture counts are now returned on bypassed builds.
Aligns CLI snapshot terminology, changing the terminology developers encounter when using the CLI.
Claude worktrees are now ignored.
buildStorybook now receives the Chromatic Project ID.
Chromatic grabs the correct version of @storybook/angular-vite.
TurboSnap v2 filters changes to .storybook/*.md and .storybook/*.txt files.
Patch build functionality is restored.
More
.storybook/mainconfig structures are supported.Fixes silent error swallowing early in CLI invocation.
The upload task now logs ancestor build details.
chromatic 1717 changes
Breaking changes 2
Individual bail subreasons are joined into a single field.
Node 20 is no longer supported, and supported Node engines are defined.
New APIs and options 1
A configuration parameter controls the git timeout.
Behavior and default changes 8
Fully TurboSnapped builds now include ancestor build details.
When TurboSnap detects no changes, upload, verify, and snapshot tasks are skipped.
Shows the full trace path for the bail file reason.
Metadata files are automatically uploaded when TurboSnap bails.
Logs untraced files and their matching glob.
Bails now include context around file adds and moves when a baseline checkout fails.
Adds additional bail details to invalidChangedFiles.
Adds additional bail details to changedPackageFiles.
Fixes and other changes 6
Metadata files are uploaded only when they have a valid S3 path.
React Native now parses the build command from the config file.
The e2e build command now handles arguments correctly when used with npm.
The command no longer overwrites artifacts without permission.
The CLI delays validation of the build-storybook script.
Static assets are no longer mis-categorized as Storybook config changes.
chromatic 1623 changes
Breaking changes 3
Android builds now target only the x86_64 ABI.
Chromatic throws an error for React Native projects using TurboSnap.
Node 18 is no longer supported, and the GitHub Action is updated to Node 24.
New APIs and options 5
Adds a config option for building multiple Android architectures.
Adds share() to the Node API.
Adds a React Native section to the config file.
A React Native build command is added.
Adds a flag for the @chromatic-com/vitest integration.
Behavior and default changes 6
The skip option can be used without a project token.
Makes Storybook metadata output generic.
Chromatic sends analytics for Storybook build failures.
Extracts the refs field from Storybook and passes it when announcing a build.
Shows more information when React Native builds are invalid.
Merge queue support is improved.
Tooling 3
Adds a React Native build stage.
Validates the @storybook/react-native version.
Chromatic upgrades to Storybook 10, allowing developers to use it with this release.
Fixes and other changes 6
Fixed getUncommittedHash in Windows environments.
Additional environment variables are included in RN builds.
React Native builds now have an output environment variable.
Retries file uploads when file deduplication fails.
Fixes a crash when checking for CLI updates.
React Native builds now check ABI compatibility before upload.
chromatic 156 changes
Breaking changes 1
Update Storybook to 10.x and upgrade dependencies.
New APIs and options 1
Adds the chromaticSha input parameter.
Behavior and default changes 1
Chromatic only uploads manifest.json, storybook.apk, and storybook.app.
Tooling 1
Chromatic adds support for iOS React Native projects.
Fixes and other changes 2
Shell commands now properly time out their process tree.
TurboSnap checks now have concurrency limits to fix out-of-memory errors with large monorepos.
chromatic 137 changes
Security 1
Fixes a security warning when running Chromatic with Node.js 24.
Fixes and other changes 6
Adds asset validation for React Native.
Chromatic supports React Native builds.
Chromatic skips the Storybook build step for React Native.
Fixes passing the signal to Execa.
Strips '+ N modules' when matching against untraced files.
Prevents writes to the log file during metadata upload.