Tutorial Visual Regression

Tutorial: Visual Regression

Pixel-compare screenshots against baselines (Pillow or Rust zyvor-diff).

Deep: Tutorial 06 · Rust Diff · Autofix and Regression.

Enable

# .env
ENABLE_REGRESSION=true
REGRESSION_THRESHOLD=1.0          # max % changed pixels
# Optional faster path:
ENABLE_RUST_PROCESSOR=true        # after: make rust

Capture baselines

make regression-update
# or
ENABLE_REGRESSION=true zyvor-qa regression --update-baselines

Baselines land in screenshots/baselines/. Current/diffs: screenshots/current/, screenshots/diffs/.

Compare

make regression
ENABLE_REGRESSION=true zyvor-qa regression
# Also during full pipeline when ENABLE_REGRESSION=true
zyvor-qa run --source local

Route sweeps

Multi-route desktop/mobile capture + diff:

zyvor-qa route-sweep https://staging.example.com --auto

See Journeys and Flows. Mission Control: Regression / Screenshot / Compare / Route sweep cards.

CI tips

• Commit baselines deliberately; review diffs in PR artifacts
• Prefer ghcr.io/hypersdk/zyaiqaagent so browsers are present
• Exit code: route-sweep fails when routes exceed visual threshold — External CI/CD

Next

Notifications and Reports · Autofix and Regression