Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk7 min

How to Set Up Reg-suit Image Comparison for a Static Website

Reg-suit compares screenshots rather than capturing pages. Learn to generate stable images, configure baselines and thresholds, publish reports, and run the workflow in CI.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Reg-suit compares screenshots; it does not capture your website. Build the static site, generate repeatable browser screenshots, point Reg-suit at their directory, and run npx reg-suit run to compare them with expected images and produce a report. The setup below covers local runs and CI, including baseline selection and optional cloud publishing.

What Reg-suit does—and what it does not do

Reg-suit is a command-line tool for visual regression testing. It compares a current set of images with expected images and creates an HTML difference report. Configured publisher plugins can store snapshots and reports in cloud storage. It does not open your static site or make screenshots: the official example runs a separate Puppeteer capture script first. See the Reg-suit project README and official Puppeteer demo.

As an Amazon Associate I earn from qualifying purchases.

Choose stable pages and capture conditions

Decide which routes matter, then choose a consistent viewport, browser, fonts, and page-ready condition. Capture the built site—not an incomplete development state—and write one image per page to a known directory. The official demo illustrates Puppeteer and a screenshot directory; its commands are an example, not a framework-specific recipe.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Keep the capture conditions the same for the baseline and candidate run. Changes in viewport, browser version, fonts, animation state, or content can create image differences unrelated to the code change you intend to review. Wait for the content you need before capture; for pages with delayed assets, define an appropriate readiness condition rather than relying only on a short arbitrary delay.

#1 Best Overall
Sale
Logitech Brio 101 Full HD 1080p Webcam for Streaming and Meetings - Black
  • Compatible with Nintendo Switch 2’s new GameChat mode
  • Auto-Light Balance: RightLight boosts brightness by up to 50%, reducing shadows so you look your best—compared to previous-generation Logitech webcams (1)
  • Privacy with a Slide: The integrated webcam cover makes it easy to get total, reliable privacy when you're not on a video call
  • Built-In Mic: The built-in microphone lets others hear you clearly during video calls
  • Easy Plug-And-Play: The Brio 101 works with most video calling platforms, including Microsoft Teams, Zoom and Google Meet—no hassle; it just works

Install Reg-suit and initialize its configuration

  1. Build your static site using the build command already used by the project.
  2. Install Reg-suit as a development dependency. The project quick start uses npm install --save-dev reg-suit; check the npm package listing and your Node.js environment for current compatibility rather than assuming an old example’s version applies.
  3. Generate the screenshots with your capture script and confirm the output directory contains the images for the pages you selected.
  4. Run npx reg-suit init from the project directory and follow the prompts for the installed version. The official README documents reg-suit init as the setup command.

The official Puppeteer demo’s older interactive transcript selects reg-keygen-git-hash-plugin and reg-publish-s3-plugin, uses .reg as the working directory, and sets screenshot as the actual-image directory. Treat that transcript as an illustration; current prompts and plugin configuration should be checked against the installed version and its plugin documentation.

Configure the actual image directory and comparison sensitivity

Reg-suit reads regconfig.json at the project root. Its documented core settings include a working directory, actual-image directory, and threshold rate. A minimal shape is:

{
  "core": {
    "workingDir": ".reg",
    "actualDir": "screenshot",
    "thresholdRate": 0
  }
}

Adjust paths to match your project. The threshold is documented as a value from 0 to 1; smaller values make the comparison more sensitive. The demo’s zero is an example, not a generally correct setting. Start with a value that fits your rendered output and review the report before deciding whether to make comparisons more or less sensitive.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
Logitech C270 720p Webcam Plug-and-Play Wide Screen Video Calling - Black
  • Compatible with Nintendo Switch 2’s new GameChat mode
  • Crisp HD 720p/30 fps video calls with diagonal 55° field of view and auto light correction. Compatible with popular platforms including Skype and Zoom.
  • The built-in noise-reducing mic makes sure your voice comes across clearly up to 1.5 meters away, even if you’re in busy surroundings.
  • C270’s RightLight 2 feature adjusts to lighting conditions, producing brighter, contrasted images to help you look good in all your conference calls.
  • The adjustable universal clip lets you attach the camera securely to your screen or laptop, or fold the clip and set the webcam on a shelf. You’re always ready for your next video call.

The README also documents optional antialias handling, detailed difference reporting through x-img-diff-js, and a concurrency setting. Their exact behavior and configuration should be verified against the current README and installed version before relying on them.

Select how Reg-suit finds expected snapshots

The key generator determines which expected snapshot set is used for comparison. The Git-hash plugin identifies a comparison commit by traversing Git branch history; the documented GitHub-flow pattern associates expected snapshots with a topic branch’s base history. The main README also lists a simple key-generator plugin for workflows that use explicit or arbitrary keys. Choose automatic Git-history mapping when it matches your branch process; choose explicit keys when your team wants to control snapshot identity directly. See the project README for the plugin list and workflow guidance.

Choose whether to publish snapshots and reports

External publishing is useful when CI needs to retrieve expected images and retain reports outside a temporary runner. It is optional: first get capture, local comparison, and report generation working.

Rank #3
Sale
NexiGo N60 1080P Webcam with Microphone, Software Control & Privacy Cover, USB HD Computer Web Camera, Plug and Play, for Zoom/Skype/Teams, Conferencing and Video Calling
  • 【Full HD 1080P Webcam】Powered by a 1080p FHD two-MP CMOS, the NexiGo N60 Webcam produces exceptionally sharp and clear videos at resolutions up to 1920 x 1080 with 30fps. The 3.6mm glass lens provides a crisp image at fixed distances and is optimized between 19.6 inches to 13 feet, making it ideal for almost any indoor use.
  • 【Wide Compatibility】Works with USB 2.0/3.0, no additional drivers required. Ready to use in approximately one minute or less on any compatible device. Compatible with Mac OS X 10.7 and higher / Windows 7, 8, 10 & 11 / Android 4.0 or higher / Linux 2.6.24 / Chrome OS 29.0.1547 / Ubuntu Version 10.04 or above. Not compatible with XBOX/PS4/PS5.
  • 【Built-in Noise-Cancelling Microphone】The built-in noise-canceling microphone reduces ambient noise to enhance the sound quality of your video. Great for Zoom / Facetime / Video Calling / OBS / Twitch / Facebook / YouTube / Conferencing / Gaming / Streaming / Recording / Online School.
  • 【USB Webcam with Privacy Protection Cover】The privacy cover blocks the lens when the webcam is not in use. It's perfect to help provide security and peace of mind to anyone, from individuals to large companies. 【Note:】Please contact our support for firmware update if you have noticed any audio delays.
  • 【Wide Compatibility】Works with USB 2.0/3.0, no additional drivers required. Ready to use in approximately one minute or less on any compatible device. Compatible with Mac OS X 10.7 and higher / Windows 7, 10 & 11, Pro / Android 4.0 or higher / Linux 2.6.24 / Chrome OS 29.0.1547 / Ubuntu Version 10.04 or above. Not compatible with XBOX/PS4/PS5.

Amazon S3 publisher

The S3 publisher documentation describes fetching earlier snapshots from S3 as expected images and publishing current snapshots and reports. A bucket must exist and be accessible to CI. Documented configuration options include bucket name, optional encryption settings, custom domain, path prefix, and SDK options.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The plugin README’s documented IAM actions include s3:DeleteObject, s3:GetObject, s3:GetObjectAcl, s3:PutObject, s3:PutObjectAcl, and s3:ListBucket. Review the current plugin guidance and your AWS account’s security requirements before granting permissions; grant only the access your workflow needs.

Google Cloud Storage and other publisher choices

The Reg-suit README lists a GCS publisher as an alternative. Choose storage based on your existing cloud environment, access-control needs, and operating costs. The cited project documentation establishes plugin support, not current cloud pricing or publisher-program availability.

Rank #4
Sale
EMEET C960 1080P Webcam with Microphone, 2 Mics, 90° FOV, Computer Camera | USB Type-A & A-to-C Adapter, Fixed Focus, Plug&Play for Zoom/Teams/Facetime/YouTube/Google Meet/Switch 2 Camera, 2025 Version
  • 1080P Webcam with Cover for Video Calls - EMEET computer webcam provides design and Optimization for professional video streaming. Realistic 1920 x 1080p video, 5-layer anti-glare lens, providing smooth video. C960 computer camera delivers 1920x1080 video with fixed focus (11.8–118.1 inches), so as to provide a clearer image. C960 USB webcam has a cover and can be removed automatically to meet your needs for privacy. For optimal image performance, use the webcam in a well-lit environment.
  • Built-in 2 Omnidirectional Mics - EMEET webcam with microphone for desktop features 2 built-in omnidirectional microphones, picking up your voice to create clear audio for communication. When installing the webcam, select EMEET C960 as the default microphone input device in your computer and video applications and select C960 as the default device in Zoom/Teams and ensure microphone permissions are enabled for proper use. Please note that C960 does not include built-in speakers.
  • Automatic Light Adjustment - Automatic exposure adjustment is applied in EMEET HD webcam 1080p so that the streaming webcam can deliver stable image performance. EMEET C960 camera for computer also features color adjustment and exposure optimization to help you look your best. For optimal video quality, it is recommended to use the webcam in normal or well-lit environments and select suitable video settings in your application. Proper lighting helps achieve a clearer and more balanced image.
  • Plug-and-Play & Upgraded USB Connectivity - New C960 webcam features both USB Type-A & A-to-C adapter connections for wider compatibility. For stable performance, connect the webcam directly to the computer's main USB port and ensure the device is recognized correctly. If a hub or docking station is used, please ensure it provides sufficient power and stable data transmission, as limited ports may affect performance. 90° wide-angle lens captures more participants without frequent adjustments.
  • High Compatibility & Multi Application - C960 webcam for laptop is compatible with Windows 10/11, macOS 10.14+, and Android TV 7.0+. Not supported: Windows Hello, TVs, tablets, or game consoles. It works with Zoom, Teams, Facetime, Google Meet, YouTube and more. Please select C960 webcam as the default camera and microphone device in your application and ensure camera/microphone permissions are enabled, especially on macOS. (Tips: Incompatible with Windows Hello)

Run Reg-suit locally

After the screenshot script has written fresh images into the configured core.actualDir, run:

npx reg-suit run

The integrated run syncs expected images, compares them, and publishes results through configured plugins; notifier plugins can report results through integrations listed by the project. If expected images or publishing are not configured, follow the prompts and plugin setup for the workflow you chose. Review the generated HTML report to decide whether differences are intended.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Add the workflow to CI

The order matters: build the site, capture screenshots, then run Reg-suit. The project’s GitHub Actions example checks out the repository with full history, sets up Node.js, installs dependencies, and runs npx reg-suit run. Adapt it to your actual build and capture scripts, and use the README’s CI guidance for the installed version.

Best Value
Logitech C920x HD Pro PC Webcam Full 1080p/30fps Video - Black
  • Compatible with Nintendo Switch 2’s new GameChat mode
  • HD lighting adjustment and autofocus: The Logitech webcam automatically fine-tunes the lighting, producing bright, razor-sharp images even in low-light settings. This makes it a great webcam for streaming and an ideal web camera for laptop use
  • Advanced capture software: Easily create and share video content with this Logitech camera that is suitable for use as a desktop computer camera or a monitor webcam
  • Stereo audio with dual mics: Capture natural sound during calls and recorded videos with this 1080p webcam, great as a video conference camera or a computer webcam
  • Full HD 1080p video calling and recording at 30 fps. You'll make a strong impression with this PC webcam that features crisp, clearly detailed, and vibrantly colored video
  1. Check out enough Git history for the selected key generator. The documented example uses fetch-depth: 0.
  2. Set up Node.js and install the project’s locked dependencies.
  3. Build the static site and run the browser capture script.
  4. Make sure the runner’s branch information is available if the Git-hash plugin uses it. Some CI jobs check out a detached HEAD; the README describes a branch-checkout workaround.
  5. Run npx reg-suit run after screenshots exist. Provide cloud credentials only if a publisher needs them.

Notifications are optional. Establish reliable capture, baseline selection, and report generation before adding GitHub, GitLab, Slack, or other notifier plugins listed by the project.

Or skip the browser setup

If your immediate need is to produce screenshot files without maintaining a browser-capture script, ScreenshotNeo can return a screenshot from one GET request. Reg-suit still performs image comparison; generate the image first, save it into your configured actual-image directory, then run Reg-suit.

cURL:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://your-static-site.example -o shot.webp

Python:

import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://your-static-site.example"}, timeout=90)
open("shot.webp", "wb").write(r.content)

Node.js:

const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://your-static-site.example' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);

See the ScreenshotNeo API documentation for request options. Cookie banners, newsletter popups, and chat widgets are removed before capture; each cleanup step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and responses identify page verdict and billing status in headers. ScreenshotNeo also offers an MCP server for AI agents, with tools including take_screenshot, get_page_info, and capture_pdf. The free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Sign up for 1,000 free screenshots a month—no card required.

Troubleshooting common setup failures

  • No screenshots are compared: Check that the capture script ran before Reg-suit, that it wrote image files, and that core.actualDir points to that directory relative to the project configuration.
  • Reg-suit cannot find a suitable expected image: Check the configured key-generator, the snapshot history or explicit key, and whether the expected set was published where the plugin looks for it.
  • Git-hash plugin fails in CI or selects the wrong base: Ensure the checkout includes the needed branch history and branch name. Detached-HEAD checkouts can hide branch context; use the project’s documented checkout workaround.
  • S3 retrieval or publishing fails: Confirm the bucket name and CI credentials, verify that the bucket is reachable from the runner, and check the plugin’s required read, write, list, and deletion access against your policy.
  • Reports show noisy differences: Compare the capture conditions for baseline and candidate runs, including viewport, browser, fonts, timing, and dynamic content. Then review whether threshold sensitivity or optional antialias handling fits the images.
  • Setup prompts differ from an online example: The Puppeteer demo transcript is older. Follow the prompts and plugin documentation for the installed version, and verify compatibility for your Node.js, browser, and CI image; the available sources do not establish a universal version matrix.

Cost, performance, and reliability considerations

Reg-suit’s project materials establish that concurrency is configurable, but do not provide a universal runtime or performance figure. Runtime depends on how many pages you capture, how long each page takes to load, and the chosen comparison and publishing setup. Keep the page set and readiness conditions intentional so CI work is predictable. Cloud storage costs depend on your provider and usage; current prices are not established by the Reg-suit plugin documentation cited here.

For dependable comparisons, retain the same capture conditions and ensure CI has the expected branch history and storage access. Treat a difference report as evidence to inspect, not an automatic judgment that a visual change is wrong: intended design changes should update the baseline through your team’s chosen process.

Quick Recap

SaleBestseller No. 1
Logitech Brio 101 Full HD 1080p Webcam for Streaming and Meetings - Black
Logitech Brio 101 Full HD 1080p Webcam for Streaming and Meetings - Black
Compatible with Nintendo Switch 2’s new GameChat mode; Built-In Mic: The built-in microphone lets others hear you clearly during video calls
$35.80
SaleBestseller No. 2
Logitech C270 720p Webcam Plug-and-Play Wide Screen Video Calling - Black
Logitech C270 720p Webcam Plug-and-Play Wide Screen Video Calling - Black
Compatible with Nintendo Switch 2’s new GameChat mode
$16.89
Bestseller No. 5
Logitech C920x HD Pro PC Webcam Full 1080p/30fps Video - Black
Logitech C920x HD Pro PC Webcam Full 1080p/30fps Video - Black
Compatible with Nintendo Switch 2’s new GameChat mode; Fully compatible with Windows 11
$67.90

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.