Freedom251 › Visual Regression Testing Software
reg-suit

What reg-suit is
reg-suit is a free command-line tool for visual regression testing. It compares current images with earlier snapshots and produces an HTML report of differences. The CLI runs locally or with CI services, while snapshots can be stored in external cloud storage such as Amazon S3 or Google Cloud Storage. In GitHub-flow projects, reg-suit identifies a topic branch’s parent commit and uses that commit’s snapshot as the expected result. A GitHub app can post comparison results in pull requests, and notifier plugins support commit statuses, GitLab merge requests, GitHub Enterprise pull requests, Slack incoming webhooks, and Chatwork. Configuration includes difference and matching thresholds, antialias handling, and parallel comparison concurrency. An optional x-img-diff-js report can describe structural changes such as inserted or moved image areas. Setup uses npm installation, project initialization, and test-image runs. The MIT-licensed project was founded in 2017.
Who it suits
reg-suit suits developers maintaining image-based visual checks in local or CI workflows. It fits projects using tools such as Puppeteer, React, Angular, Vue, Storybook, or Sketch previews.
What it does well
- Free command-line visual regression testing
- Runs locally and with CI services
- Cloud snapshot storage support
- Pull request and chat notifications
- Configurable comparison thresholds
What to know first
- No cross-browser capture
- Requires command-line setup
- External cloud storage is used for snapshots
Getting started
- Install reg-suit globally with npm
- Initialize reg-suit in your project
- Configure snapshot storage and comparison settings
- Connect any required notifier plugins
- Run reg-suit against your test images
- Review the generated HTML difference report
Verdict
reg-suit focuses on snapshot comparison, HTML difference reports, and development-workflow notifications.
Questions
How much does reg-suit cost?
It is free and has a free plan.
Where can it run?
The command-line tool works on a local machine and with CI services.
Where are snapshots stored?
Snapshot images are stored in external cloud storage, including AWS S3 and Google Cloud Storage.
Which integrations are available?
Listed plugins support GitHub, GitLab, GitHub Enterprise, Slack, Chatwork, AWS S3, and Google Cloud Storage.
Does it support cross-browser capture?
No. Cross-browser capture is not supported.
What license does it use?
The project README states that reg-suit is licensed under MIT.
Facts from reg-suit's own pages
- Branch comparison
- Its GitHub-flow support detects the parent commit of a topic branch and uses that commit’s snapshot as the expected comparison result. · reg-viz.github.io, 7 Oct 2026
- Comparison controls
- Configuration supports difference thresholds, antialias handling, matching thresholds, and parallel comparison concurrency. · github.com, 7 Oct 2026
- Detailed differences
- An optional x-img-diff-js engine can show structural information about image differences, including inserted or moved parts. · github.com, 8 Oct 2026
- Founded
- 2017 · reg-viz.github.io, 28 Sept 2026
- GitHub flow
- The GitHub flow feature detects a topic branch’s parent commit and uses that commit’s snapshot as the expected comparison result. · reg-viz.github.io, 8 Oct 2026
- GitHub integration
- The GitHub app can post comparison results as pull request comments; the repository also describes commit-status notifications through its GitHub notifier plugin. · github.com, 7 Oct 2026
- GitHub notifications
- With the GitHub app and notifier plugin, results can be sent as commit status and pull request comments. · github.com, 8 Oct 2026
- Image comparison
- Its configuration supports difference thresholds, antialias handling, and parallel comparison processes. · github.com, 8 Oct 2026
- Integrations
- Listed plugins support S3, Google Cloud Storage, GitHub, GitLab, Slack, and Chatwork. · github.com, 8 Oct 2026
- Intended users
- The site presents reg-suit for projects that need image-based visual regression testing, including example projects using Puppeteer, React, Angular, Vue, Storybook, and Sketch previews. · reg-viz.github.io, 7 Oct 2026
- License
- The repository identifies the project as MIT licensed. · github.com, 8 Oct 2026
- Local and CI use
- The maker says reg-suit works with CI services and on a local machine. · reg-viz.github.io, 8 Oct 2026
- Other integrations
- Listed notifier plugins support GitLab merge request comments, GitHub Enterprise pull request comments, Slack incoming webhooks, and Chatwork. · github.com, 7 Oct 2026
- Project audience
- The maker provides examples for projects using Puppeteer, React, Angular, Vue.js, Storybook, and Sketch previews. · reg-viz.github.io, 8 Oct 2026
- Purpose
- reg-suit is a command-line tool for visual regression testing that compares current images with previous images and creates an HTML report of differences. · reg-viz.github.io, 8 Oct 2026
- Security
- The repository page links to a security policy; the opened page does not state specific certifications or compliance claims. · github.com, 8 Oct 2026
- Setup
- The documented setup installs reg-suit with npm, then initializes it in a project and runs it from the command line. · reg-viz.github.io, 8 Oct 2026
- Snapshot storage
- It can store snapshots in external cloud storage such as AWS S3 or Google Cloud Storage. · github.com, 8 Oct 2026
- Support and contribution
- The repository says pull requests are welcome; the pages opened do not state a paid support offering. · github.com, 7 Oct 2026
- Where it runs
- The CLI works with CI services and on a local machine. · reg-viz.github.io, 7 Oct 2026
Where reg-suit stands on Freedom251
- Visual Regression Testing Software#23 of 26
