# reg-viz/reg-suit

:recycle: Visual Regression Testing tool

Repository: https://github.com/reg-viz/reg-suit
Canonical: https://ross.abutalabs.com/products/reg-suit
Homepage: https://reg-viz.github.io/reg-suit
Language: TypeScript
License: MIT
License Family: permissive
Topics: visual-tests, nodejs, regression-testing, automation-tests, reg-suit
Last push: 2026-08-14T20:54:39+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 43, longevity 100
- inputs: {"age_days": 3355, "days_push": 19, "days_rel": 170, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1287, forks 110 (observed 2026-08-28T04:04:15.076110+00:00)

## What it is
reg-suit is a command-line tool for visual regression testing that compares current screenshots against previous snapshots and generates HTML diff reports. It stores snapshots in cloud storage like S3 or GCS and integrates with CI services and GitHub via a plugin system.

## Use cases
- compare screenshots between commits to catch visual regressions
- store snapshot images in S3 or GCS for review
- report visual diffs as GitHub PR comments and commit statuses
- run visual snapshot tests in CI pipelines
- detect the parent commit of a topic branch automatically for comparison
- generate HTML reports of image differences

## When to choose
- you need visual regression testing for web UIs or any image assets
- you want a CLI that integrates easily with any CI service
- you use GitHub flow and want automated PR feedback on visual changes
- you need pluggable snapshot storage and notification options

## When to avoid
- you need end-to-end functional testing rather than visual comparison
- your project is not Node.js-based and you prefer a language-native tool
- you want a hosted visual testing service with built-in dashboards

## Facets
- artifact type: cli-tool
- maturity: active
- function: testing, e2e-testing, cli, image-processing, plugin-system
- domain: testing, web-development, developer-tools, frontend
- platform: cli, cross-platform
- tags: visual-regression-testing, snapshot-testing, screenshot-comparison, ci-integration, github-app, s3, gcs, nodejs

## Member repositories
- reg-viz/reg-suit (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:15.076110+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:56:06.618983+00:00, confidence not recorded.
  - readme: https://github.com/reg-viz/reg-suit (fetched 2026-08-28T04:04:15.076110+00:00, sha b76fe3706a03)
  - homepage: https://reg-viz.github.io/reg-suit (fetched 2026-08-29T12:12:14.015893+00:00, sha 8c6bc28ee4dc)
  - registry_npm: https://registry.npmjs.org/reg-suit (fetched 2026-08-29T12:12:14.018363+00:00, sha 59eb2a04cf3e)
- Data as of 2026-08-30T08:39:29.467469+00:00.