Skip to content

✨ v0.17.0

Choose a tag to compare

@github-actions github-actions released this 04 Dec 07:26
· 0 commits to 058e321084aa8f6828535303c927738b68c06ce1 since this release

🎨 Big Update: Smarter Color Comparison!

This release completely overhauls how Vizzly detects visual differences. We've upgraded from YIQ-based color comparison to CIEDE2000 (ΔE00) - the industry standard for how humans actually perceive color differences.

Why this is awesome

The old YIQ threshold was... kind of broken, to be honest. A threshold of 0.1 let almost anything through, while 0.001 was so strict it would flag tiny run-to-run variance as failures. There was no sweet spot!

CIEDE2000 fixes this with an intuitive scale where 1.0 = the Just Noticeable Difference (JND). If two colors look different to your eyes, Vizzly will catch it. If they look the same, you won't get false positives. It's that simple.

⚠️ Breaking Change: New Threshold Scale

The threshold scale has changed completely:

What Before After
Unit YIQ normalized (0.0-1.0) CIEDE2000 Delta E
Default 0.1 2.0

New threshold reference:

  • 0.0 = exact pixel matching (super strict)
  • 1.0 = Just Noticeable Difference - very strict
  • 2.0 = recommended default (ignores sub-pixel rendering variance) ⭐
  • 3.0+ = more permissive

What changed

  • Upgraded to honeydiff v0.5.0 with CIEDE2000 color difference
  • Fixed threshold propagation - your comparison.threshold config now properly flows to cloud builds
  • UI improvements: hid view mode toggle on mobile, added firefox-mobile test config

Migrating

If you have a custom threshold configured, here's a quick conversion guide:

  • Default (0.1) → Use 2.0
  • Very strict (0.01) → Try 1.0 (JND)
  • Permissive (0.5+) → Try 4.0-6.0

I recommend starting with 2.0 and adjusting based on your specific needs!