Open source · MIT license

VisualGuard

See what changed.
Review with confidence.

An open-source visual testing package by Shubham Tiwari, the creator of Zentauri UI. Bring visual evidence into your development workflow.

What it does

A closer look at your UI.

Compare your interfaces

Compare two environments, saved baselines, or checkpoints in Playwright tests.

Cover different screens

Configure viewports and browser settings to inspect responsive changes.

Inspect the evidence

Review screenshots, pixel differences, and DOM findings together in an interactive report.

Choose optional AI

Use deterministic comparisons on their own, or add Gemini or Ollama analysis.

These capabilities reflect the current source documentation. Check the documentation for your installed version; the source README includes changes planned for a future major release.

Getting started

Start with a visual check.

The current source requires Node.js 22.12 or newer and Playwright browser binaries. After initialization, set your URLs and routes before running a comparison.

Installation guide
Quick start from the source README
npm install -D visualguard playwright
npx playwright install chromium
npx visualguard init
npx visualguard doctor
npx visualguard test
npx visualguard report

Alongside Zentauri UI

Build the component. Review its appearance.

Use typography previews as candidates for visual checks when changing font scales, content rhythm, or responsive layouts. Our typography plan includes VisualGuard coverage as a follow-up verification step.