Debug Visual Regression

When a user mentions failing visual tests or screenshot differences, follow these steps to investigate and help them understand what changed.

Step 1: Read the Comparison Data

Use the Read tool to get .vizzly/report-data.json:

Read .vizzly/report-data.json

If the file is too large, use Bash to extract just the failing comparisons:

cat .vizzly/report-data.json | node -e "
  const data = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf8'));
  console.log(JSON.stringify(data.comparisons?.filter(c => c.status === 'failed'), null, 2));
"