actions-marketplace-validations/Publish to Chromatic
Publish your Storybook to Chromatic and run visual regression tests
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Feb 23, 2026
- License
- MIT
Pinned Snippet
uses: actions-marketplace-validations/chromaui_action@5ec258af08deb3e8c36653bd618cb7fe52090031 # no releases — HEAD as of 2026-07-13tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| autoAcceptChanges | Automatically accept all changes in chromatic: boolean or branchname | no | — |
| branchName | Override the branch name | no | — |
| buildScriptName | The npm script that builds your Storybook [build-storybook] | no | — |
| buildCommand | The command that builds your Storybook (when your build command does not exist in "scripts" of your package.json) | no | — |
| chromaticSha | The git SHA of the commit that should be tested in Chromatic. Defaults to the SHA of the current branch tip on which the action is running. Use with caution, as it may yield unexpected results. | no | — |
| configFile | Path from where to load the Chromatic config JSON file. | — | — |
| cypress | Run build against `@chromatic-com/cypress` test archives | no | — |
| debug | Output verbose debugging information | no | — |
| diagnosticsFile | Write process context information to a JSON file | no | — |
| dryRun | Run without actually publishing to Chromatic | no | — |
| exitOnceUploaded | Exit with 0 once the built version has been sent to chromatic: boolean or branchname | no | — |
| exitZeroOnChanges | Positive exit of action even when there are changes: boolean or branchname | no | — |
| externals | Disable TurboSnap when any of these files have changed since the baseline build | no | — |
| fileHashing | Whether to apply file hashing to skip uploading unchanged files (default: true) | no | — |
| forceRebuild | Do not skip build when a rebuild is detected | no | — |
| ignoreLastBuildOnBranch | Do not use the last build on this branch as a baseline if it is no longer in history (i.e. branch was rebased) | no | — |
| logFile | Write CLI logs to a file | no | — |
| logLevel | One of: silent, error, warn, info, debug (default: info) | no | — |
| logPrefix | Custom prefix for log messages (default: current timestamp) | no | — |
| onlyChanged | Enables TurboSnap: Only run stories affected by files changed since the baseline build | no | — |
| onlyStoryNames | Only run a single story or a subset of stories by their name | no | — |
| onlyStoryFiles | Only run a single story or a subset of stories by their filename(s) | no | — |
| outputDir | Relative path to target directory containing your Storybook (a temporary directory is used if this is not set) | no | — |
| playwright | Run build against `@chromatic-com/playwright` test archives | no | — |
| preserveMissing | Deprecated, use onlyChanged, onlyStoryNames or onlyStoryFiles instead | no | — |
| projectToken | Your chromatic project token (best provided via env.CHROMATIC_PROJECT_TOKEN) | no | — |
| repositorySlug | Override the repository slug (e.g. ownerName/repositoryName) | no | — |
| skip | Skip Chromatic tests, but mark the commit as passing | no | — |
| skipUpdateCheck | Skips Chromatic CLI update check | no | — |
| storybookBaseDir | Relative path from repository root to Storybook project root | no | — |
| storybookBuildDir | Provide a directory with your built storybook; use if you have already built your storybook | no | — |
| storybookConfigDir | Relative path from where you run Chromatic to your Storybook config directory | no | — |
| storybookLogFile | Write Storybook build logs to a file | no | — |
| token | Your github token | no | — |
| traceChanged | Print dependency trace for changed files to affected story files; set to "expanded" to list individual modules | no | — |
| untraced | Disregard these files and their dependencies when tracing dependent stories for TurboSnap | no | — |
| uploadMetadata | Upload Chromatic metadata files as part of the published Storybook | no | — |
| workingDir | Working directory for the package.json file | no | — |
| zip | Publish your Storybook to Chromatic as a single zip file instead of individual content files | no | — |
| junitReport | Write build results to a JUnit XML file | no | — |
Outputs
| name | description |
|---|---|
| code | The exit code for the current run of the Chromatic CLI |
| url | An alias for the build URL (e.g. https://www.chromatic.com/build?appId=<app id goes here>&number=<build number>) |
| buildUrl | The build URL (e.g. https://www.chromatic.com/build?appId=<app id goes here>&number=<build number>) |
| storybookUrl | The Storybook preview URL for your current branch / Pull Request (e.g. https://<app id goes here>-<branch hash>.chromatic.com/) |
| specCount | The number of stories in the published Storybook |
| componentCount | The number of components in the published Storybook |
| testCount | The number of tests on the build |
| changeCount | The number of tests with visual changes, including any inherited changes (e.g. due to TurboSnap) |
| errorCount | The number of tests with error(s), including any inherited errors (e.g. due to TurboSnap) |
| interactionTestFailuresCount | The number of stories with interaction test failures |
| actualCaptureCount | The number of captured snapshots |
| inheritedCaptureCount | The number of inherited (not captured) snapshots (e.g. due to TurboSnap) |