# What changed in chromatic

> 108 changes in chromatic 13 to 18 from its official release notes, upgrade guides and advisories: 6 breaking, 1 security, 13 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/chromatic/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## chromatic 18

### New APIs and options

- TurboSnap v2 supports the --externals option. (18.13.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.13.0)
- TurboSnap v2 supports the --untraced option. (18.13.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.13.0)
- A subcommand was added to generate a TurboSnap v2 manifest. (18.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.6.0)
- Chromatic supports CHROMATIC_DISABLE_TELEMETRY for controlling telemetry. (18.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.3.0)
- Chromatic supports DO_NOT_TRACK for controlling telemetry. (18.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.3.0)
- Adds a --help command-line parameter for publishAction. (18.1.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.1.0)

### Behavior and default changes

- TurboSnap v2 applies gitignore values from sibling packages in monorepos. (18.13.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.13.0)
- TurboSnap v2 skips gitignored files in the Storybook config directory. (18.13.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.13.0)
- TurboSnap v2 skips files that Git ignores. (18.12.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.12.0)
- TurboSnap v2 hashes are always uploaded when using Chromatic. (18.9.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.9.0)
- Sets component owners when present. (18.8.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.8.0)
- Paths in ctx.storybook are resolved to absolute paths. (18.4.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.4.0)
- Storybook main config parsing is improved. (18.4.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.4.0)
- TurboSnap status changes from “Skipped” to “Bypassed.” (18.1.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.1.0)
- CLI task lists and task output now render with Clack, changing the command-line presentation. (18.0.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.0.0)

### Tooling

- Chromatic communicates the number of ignored tests. (18.11.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.11.0)
- Chromatic parses PNPM lock files and supports PNPM workspaces. (18.10.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.10.0)
- TurboSnap v2 is released and runs alongside v1. (18.7.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.7.0)
- Chromatic supports installing dependencies with pnpm. (18.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.6.0)
- TurboSnap v2 adds story detection. (18.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.6.0)
- TurboSnap v2 adds Storybook version detection. (18.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.6.0)
- Diagnostics and debug logging include more git info for ancestor calculation. (18.5.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.5.0)

### Fixes and other changes

- Fixes parsing of Azure DevOps slugs. (18.12.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.12.2)
- Removes the alpha warning from React Native builds. (18.12.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.12.2)
- Lists untracked files relative to the repository root. (18.12.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.12.1)
- Adds ADO provider support. (18.12.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.12.0)
- Uses a generic speedUpCI message. (18.12.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.12.0)
- Single-file staticDirs entries are hashed in the TurboSnap v2 manifest. (18.10.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.10.2)
- Hash collection is skipped when TurboSnap is explicitly disabled. (18.10.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.10.2)
- Users are advised when the Storybook config directory is invalid. (18.10.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.10.1)
- Fixes parsing of PNPM 12 multi-document lockfiles. (18.10.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.10.0)
- TurboSnap v1 runs when no files have changed. (18.9.6) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.9.6)
- Chromatic now follows committed symlinks when checking out baseline lockfiles. (18.9.5) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.9.5)
- Users are advised when TurboSnap v2 runs without dependencies. (18.9.5) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.9.5)
- Storybook resolution paths are logged. (18.9.4) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.9.4)
- TurboSnap v2 context is added to Sentry. (18.9.4) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.9.4)
- Globals are determined by their imports, fixing how Chromatic identifies globals. (18.9.3) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.9.3)
- Chromatic reads the Storybook version from the config directory first, then falls back to the previous lookup. (18.9.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.9.1)
- ENAMETOOLONG errors are now ignored. (18.8.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.8.1)
- Webpack escape characters are stripped from file paths. (18.8.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.8.1)
- Build failures during Vitest runs no longer reference Storybook, making the error output relevant to the test run. (18.7.3) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.7.3)
- TurboSnap errors in Vitest runs are now more descriptive, helping developers understand failures. (18.7.3) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.7.3)
- TurboSnap v2 now filters data URLs. (18.7.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.7.2)
- Sentry tags are now added to TurboSnap v2 events, making those events easier to identify. (18.7.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.7.2)
- Resolves the correct E2E package when multiple packages are installed. (18.7.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.7.1)
- Capture counts are now returned on bypassed builds. (18.6.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.6.2)
- Aligns CLI snapshot terminology, changing the terminology developers encounter when using the CLI. (18.6.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.6.1)
- Claude worktrees are now ignored. (18.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.6.0)
- buildStorybook now receives the Chromatic Project ID. (18.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.3.0)
- Chromatic grabs the correct version of @storybook/angular-vite. (18.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.3.0)
- TurboSnap v2 filters changes to .storybook/*.md and .storybook/*.txt files. (18.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.7.4), [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.3.0)
- Patch build functionality is restored. (18.2.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.2.0)
- More `.storybook/main` config structures are supported. (18.2.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.2.0)
- Fixes silent error swallowing early in CLI invocation. (18.0.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.0.1)
- The upload task now logs ancestor build details. (18.0.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v18.0.0)

## chromatic 17

### Breaking changes

- Individual bail subreasons are joined into a single field. (17.2.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.2.0)
- Node 20 is no longer supported, and supported Node engines are defined. (17.0.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.0.0)

### New APIs and options

- A configuration parameter controls the git timeout. (17.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.3.0)

### Behavior and default changes

- Fully TurboSnapped builds now include ancestor build details. (17.8.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.8.0)
- When TurboSnap detects no changes, upload, verify, and snapshot tasks are skipped. (17.7.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.7.0)
- Shows the full trace path for the bail file reason. (17.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.6.0)
- Metadata files are automatically uploaded when TurboSnap bails. (17.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.6.0)
- Logs untraced files and their matching glob. (17.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.6.0)
- Bails now include context around file adds and moves when a baseline checkout fails. (17.5.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.5.0)
- Adds additional bail details to invalidChangedFiles. (17.4.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.4.0)
- Adds additional bail details to changedPackageFiles. (17.1.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.1.0)

### Fixes and other changes

- Metadata files are uploaded only when they have a valid S3 path. (17.7.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.7.2)
- React Native now parses the build command from the config file. (17.7.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.7.1)
- The e2e build command now handles arguments correctly when used with npm. (17.4.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.4.1)
- The command no longer overwrites artifacts without permission. (17.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.3.0)
- The CLI delays validation of the build-storybook script. (17.0.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.0.1)
- Static assets are no longer mis-categorized as Storybook config changes. (17.0.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v17.0.1)

## chromatic 16

### Breaking changes

- Android builds now target only the x86_64 ABI. (16.8.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.8.0)
- Chromatic throws an error for React Native projects using TurboSnap. (16.2.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.2.0)
- Node 18 is no longer supported, and the GitHub Action is updated to Node 24. (16.0.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.0.0)

### New APIs and options

- Adds a config option for building multiple Android architectures. (16.10.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.10.0)
- Adds share() to the Node API. (16.10.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.10.0)
- Adds a React Native section to the config file. (16.5.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.5.0)
- A React Native build command is added. (16.4.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.4.0)
- Adds a flag for the @chromatic-com/vitest integration. (16.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.3.0)

### Behavior and default changes

- The skip option can be used without a project token. (16.9.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.9.0)
- Makes Storybook metadata output generic. (16.7.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.7.0)
- Chromatic sends analytics for Storybook build failures. (16.6.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.6.0)
- Extracts the refs field from Storybook and passes it when announcing a build. (16.5.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.5.0)
- Shows more information when React Native builds are invalid. (16.3.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.3.0)
- Merge queue support is improved. (16.2.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.2.0)

### Tooling

- Adds a React Native build stage. (16.7.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.7.0)
- Validates the @storybook/react-native version. (16.5.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.5.0)
- Chromatic upgrades to Storybook 10, allowing developers to use it with this release. (16.4.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.4.0)

### Fixes and other changes

- Fixed getUncommittedHash in Windows environments. (16.10.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.10.1)
- Additional environment variables are included in RN builds. (16.9.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.9.1)
- React Native builds now have an output environment variable. (16.8.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.8.0)
- Retries file uploads when file deduplication fails. (16.6.3) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.6.3)
- Fixes a crash when checking for CLI updates. (16.6.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.6.2)
- React Native builds now check ABI compatibility before upload. (16.6.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v16.6.1)

## chromatic 15

### Breaking changes

- Update Storybook to 10.x and upgrade dependencies. (15.0.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v15.0.0)

### New APIs and options

- Adds the chromaticSha input parameter. (15.2.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v15.2.0)

### Behavior and default changes

- Chromatic only uploads manifest.json, storybook.apk, and storybook.app. (15.1.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v15.1.0)

### Tooling

- Chromatic adds support for iOS React Native projects. (15.1.0) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v15.1.0)

### Fixes and other changes

- Shell commands now properly time out their process tree. (15.3.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v15.3.1)
- TurboSnap checks now have concurrency limits to fix out-of-memory errors with large monorepos. (15.1.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v15.1.1)

## chromatic 13

### Security

- Fixes a security warning when running Chromatic with Node.js 24. (13.3.2) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v13.3.2)

### Fixes and other changes

- Adds asset validation for React Native. (13.3.5) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v13.3.5)
- Chromatic supports React Native builds. (13.3.5) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v13.3.5)
- Chromatic skips the Storybook build step for React Native. (13.3.5) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v13.3.5)
- Fixes passing the signal to Execa. (13.3.4) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v13.3.4)
- Strips '+ N modules' when matching against untraced files. (13.3.3) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v13.3.3)
- Prevents writes to the log file during metadata upload. (13.3.1) — [release notes](https://github.com/chromaui/chromatic-cli/releases/tag/v13.3.1)