visual-differ

CLI tool for comparing PNG screenshots between two directories using pixel-perfect image comparison with HTML reports.

Image comparison powered by pixelmatch.

Usage

``bash npx visual-differ`

`$3`

- - Directory containing baseline screenshots -- Directory containing candidate screenshots - - Directory where the HTML report will be written

`$3`

- HTML Report at output-dir/index.html- Visual comparison with side-by-side images and diffs - Diff Images atoutput-dir/*.png - Visual diff overlays for changed images

`$3`

- 0- All images match -1` - Differences detected or files removed

CI Integration

The exit codes make this tool suitable for CI/CD pipelines. A non-zero exit code will fail your build when visual regressions are detected.

Requirements

- Node.js >= 24.0.0
- PNG images only

Contributing

See CONTRIBUTING.md for development setup and guidelines.

visual-differ

CLI tool for comparing PNG screenshots between two directories using pixel-perfect image comparison with HTML reports.

Image comparison powered by pixelmatch.

Usage

``bash npx visual-differ`

`$3`

- - Directory containing baseline screenshots -- Directory containing candidate screenshots - - Directory where the HTML report will be written

`$3`

- HTML Report at output-dir/index.html- Visual comparison with side-by-side images and diffs - Diff Images atoutput-dir/*.png - Visual diff overlays for changed images

`$3`

- 0- All images match -1` - Differences detected or files removed

CI Integration

The exit codes make this tool suitable for CI/CD pipelines. A non-zero exit code will fail your build when visual regressions are detected.

Requirements

- Node.js >= 24.0.0
- PNG images only

Contributing

See CONTRIBUTING.md for development setup and guidelines.