Skip to content
SPECIFICTION
Get listed

Visual Regression Tracker

github.com

WebWindowsmacOSLinuxiOSAndroid
Visit github.com
Spec score 7.1 #9 of 17 in Visual Testing

What it is

Visual Regression Tracker compares submitted screenshots with accepted baselines to flag unexpected visual changes. It keeps baseline history and lets teams exclude image regions from comparisons. Projects can choose among Pixelmatch, Looks-Same, Odiff, and a VLM comparison provider. The review dashboard supports side-by-side, diff, scrubber, and onion-skin views, with one-click approval. Feature branches inherit the main branch baseline until a change is approved, and builds can post commit status to GitHub or GitLab. The project lists agents for Playwright, Cypress, CodeceptJS, and Robot Framework, plus JavaScript, Java, Python, and .NET SDKs; its REST API supports other languages. A standalone JAR can compare PDFs as well as images. Deployment is self-hosted using Docker images, and the project says this keeps data inside the user's intranet. The documented screenshot upload payload limit is 20 MB. Each project has one owner; members can view snapshots and approve changes, while some actions are owner-only. It is open source under Apache-2.0.

Spec sheet

Purpose
Visual Regression Tracker is an open-source, self-hosted tool for visual testing and managing test results.Read 9 Oct 2026 · github.com
Deployment
Setup uses Docker images, and Docker must be installed on the host machine.Read 9 Oct 2026 · github.com
API
The README says REST API interfaces allow use from programming languages beyond the listed SDKs.Read 4 Oct 2026 · github.com
License
The GitHub repository identifies its license as Apache-2.0.Read 9 Oct 2026 · github.com
Access control
The project documentation says each project has one owner, and members can view snapshots and approve changes while owner-only actions are restricted.Read 4 Oct 2026 · docs.vregt.com
Baseline history
The tool tracks how baseline images change over time and supports ignoring selected image regions.Read 9 Oct 2026 · github.com
Branch baselines
The documentation says feature branches inherit the main branch baseline until a change is approved.Read 4 Oct 2026 · docs.vregt.com
Comparison methods
Available comparison providers include Pixelmatch, Looks-Same, Odiff, and a vision-language-model option, configurable per project.Read 9 Oct 2026 · github.com
Data location
The project describes its self-hosted deployment as keeping data inside the user's intranet.Read 9 Oct 2026 · github.com
Framework integrations
The repository lists native agents for Playwright, Cypress, CodeceptJS, and Robot Framework.Read 9 Oct 2026 · github.com
Framework support
The README lists agents for Playwright, Cypress, CodeceptJS, and Robot Framework, plus SDKs for JavaScript, Java, Python, and .NET.Read 4 Oct 2026 · github.com
How it works
It compares submitted images pixel by pixel against accepted baseline images and reports unexpected changes.Read 9 Oct 2026 · github.com
Logging
Optional Elasticsearch logging can be monitored through Kibana and uses additional memory and CPU.Read 9 Oct 2026 · github.com
PDF comparison
A standalone JAR can compare PDF files and images from a folder.Read 9 Oct 2026 · github.com
Platform coverage
It supports visual testing for web, mobile, and desktop wherever a screenshot can be captured.Read 9 Oct 2026 · github.com
Pull request gating
The documentation says builds can post commit status to GitHub or GitLab.Read 4 Oct 2026 · docs.vregt.com
Review workflow
The dashboard supports side-by-side, diff, scrubber, and onion-skin comparisons, with one-click approval.Read 4 Oct 2026 · docs.vregt.com
SDKs and API
It provides JavaScript, Java, Python, and .NET SDKs, plus a REST API for other languages.Read 9 Oct 2026 · github.com
Support and community
The README directs users to a Telegram group and invites bug reports, questions, ideas, and feedback through tickets.Read 9 Oct 2026 · github.com
Supported image inputs
The README says it can compare PDFs as well as images using a standalone jar.Read 4 Oct 2026 · github.com
Upload limit
The documented maximum screenshot upload payload is 20 MB.Read 4 Oct 2026 · docs.vregt.com

Strong points and limits

Strong points

  • Supports four configurable comparison methods.
  • Dashboard offers multiple review views and one-click approval.
  • Integrates with listed test frameworks and CI systems.
  • Can compare PDFs using a standalone JAR.
  • Self-hosting keeps data inside the user's intranet.

Limits

  • Screenshot upload payload is limited to 20 MB.
  • Each project has one owner.
  • Some actions are restricted to the owner.

Who it suits

It suits development teams that want to review screenshot changes in web, mobile, or desktop testing workflows and keep deployment self-hosted. Teams should check the upload cap and owner-only controls against their review process.

Verdict

Visual Regression Tracker pairs baseline comparisons with review and approval workflows, framework agents, SDKs, and an API. Its 20 MB upload limit and owner-based permissions are worth checking before adoption.

Where Specifiction places it

Alternatives to Visual Regression TrackerAll alternatives →