Building the product · Independent · 19 Oct 2026

mapbox/pixelmatch

The smallest, simplest and fastest JavaScript pixel-level image comparison library

← Building the product

In simple English

This tool compares two pictures and highlights where they look different. It ignores tiny shifts caused by text smoothing and screen rendering. You can use it in your automated tests to check if your web page design changed by mistake. It is very fast and requires no complex setup. It costs nothing to use and runs entirely on your own computer.

What it is

Pixelmatch is a tiny JavaScript library for comparing two images at the pixel level. It detects anti-aliasing and calculates color differences to spot real visual changes without false alarms.

What it is good for

Solo builders who want to catch visual bugs in automated website tests or app screenshots without paying for heavy testing services.

Stars7.0k
LicenceISC
Latestv8.0.0 (2026-10-06)checked 19 Oct 2026
Last code change2026-10-06
Written inJavaScript
Setup effort
2 / 5
Payoff
4 / 5
Good
  • Runs very fast with no external dependencies.
  • Smart enough to ignore minor text smoothing differences.
  • Works in both Node.js and web browsers.
Watch for
  • Requires writing a small script to load and save image files.
  • Both images must have the exact same pixel dimensions.
  • Does not read PNG files on its own without helper libraries.
Replaces

Manual visual inspection of screenshots

Works well with

pngjs

Similar repositories
  • tsayen/dom-to-image11k stars

    Turns DOM nodes into images so you can capture them for comparison.

Also reviewed on Repo Radar
  • python/mypy21k stars

    The reference type checker for Python, run from the command line.

  • HypothesisWorks/hypothesis9.1k stars

    A Python library that generates test inputs and reduces any failure to the smallest example that still fails.

  • wntrblm/nox1.6k stars

    Runs your tests and other jobs in fresh isolated environments, described in an ordinary Python file.

Install
npm install pixelmatch

Independent: reviewed for Repo Radar outside the daily editions. Every independent repository

Get the next edition in your inbox

A dozen repositories, opened and checked. The licence read, the last release dated, and the ones that did not make it named with the reason. It is the half most lists leave out.

No tracking pixels. One click to leave. The archive stays free either way.

We use your address to send the edition and nothing else. Confirm by email, leave in one click. How we handle it.