BlazeDiff — a high-performance diff ecosystem for JavaScript applications. Originally built as a pixel-perfect image comparison library that's 1.5x faster than pixelmatch, BlazeDiff has evolved into a comprehensive suite of blazing-fast diff tools including image comparison, object diffing, perceptual quality metrics, web components, and React components for visualizing differences.
- @blazediff/core - Pixel-perfect image comparison (1.5x faster than pixelmatch)
- @blazediff/object - High-performance object diffing with detailed change tracking
- @blazediff/ssim - SSIM, MS-SSIM, and Hitchhiker's SSIM for perceptual quality assessment
- @blazediff/gmsd - Gradient Magnitude Similarity Deviation metric
- @blazediff/bin - CLI with multiple algorithms (diff, GMSD, SSIM, MS-SSIM, Hitchhiker's SSIM)
- @blazediff/react - React components for diff visualization
- @blazediff/ui - Framework-agnostic web components
- Documentation - Complete API reference and guides
- Examples - Interactive demos and code samples
- Benchmarks - Performance comparisons and metrics
BlazeDiff delivers significant performance improvements across all components:
- Image Pixel-by-Pixel: ~50% faster than pixelmatch (up to 88% on identical images)
- SSIM: ~25% faster than ssim.js, ~70% faster with Hitchhiker's SSIM
- Object Diff: ~55% faster than microdiff (up to 96% on identical arrays)
View Detailed Benchmarks - Complete performance data, test methodology, and hardware specifications.
Contributions are welcome! Please see the Contributing Guide for details.
MIT License - see LICENSE file for details.
The @blazediff/ssim and @blazediff/gmsd packages implement perceptual quality metrics based on published research. See the licenses folder for detailed attribution and licensing information:
- SSIM - Zhou Wang et al., IEEE 2004
- MS-SSIM - Zhou Wang et al., Asilomar 2003
- Hitchhiker's SSIM - Venkataramanan et al., IEEE Access 2021
- Image diffing built on the excellent pixelmatch algorithm
- SSIM and MS-SSIM based on groundbreaking research by Zhou Wang, Alan C. Bovik, and colleagues
- Hitchhiker's SSIM based on research by Venkataramanan, Wu, Bovik, Katsavounidis, and Shahid
- GMSD based on research by Xue, Zhang, Mou, and Bovik
Built for high-performance difference detection across images and data structures