BackstopJS

BackstopJS is a visual regression testing tool that compares website screenshots before and after code changes to help developers catch unintended layout or…

  • Development
  • Tools & Utilities
BackstopJS is a visual regression testing tool that compares website screenshots before and after code changes to help developers catch unintended layout or design shifts across devices.

Platform availability

Available on 0 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

53/100 Fair

Maintained
68last commit 74 days ago
Popular
777,204 GitHub stars
Easy to install
250 install platforms, install notes, Docker image
Light to run
No data
Security check
201 serious finding, 25 minor, CI, tests, OpenSSF Scorecard 3.7/10

Based on 4 of 5 factors.

GitHub stars
7,204
Open issues
577
Last commit
2026-09-08
Latest release
v3.8.8
License
MIT
Activity
stale

Checked 2 days ago - source: GitHub (garris/BackstopJS)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Create your BackstopJS project first Run `backstop init` in an empty folder where you want the tests to live. It creates the settings file and test folders you need, but it can overwrite existing files, so don't run it in a folder with important work. source
  • Install it inside your project Run `npm install backstopjs` from your project root, then call `./node_modules/.bin/backstop` for commands. This keeps the project using its own copy of BackstopJS, so tests won't fail because a missing or different version is used. source
  • Keep your settings and test data safe BackstopJS uses `backstop.json` for its settings and the `backstop_data` folder for screenshots, reports, and reference images. If you delete, move, or accidentally overwrite those, you can lose your test setup and the baseline images it compares against. source

Fetched 53 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Is it safe to run backstop init in a folder that already has project files?

No, the docs say to run it in an empty folder because it can overwrite existing files.

How should I install BackstopJS so a project uses its own copy?

Run npm install backstopjs from the project root and call ./node_modules/.bin/backstop for commands. This keeps the project using its own copy of BackstopJS.

What files should I back up to preserve BackstopJS tests and baselines?

Keep backstop.json and the backstop_data folder, which stores screenshots, reports, and reference images. Deleting or overwriting those can lose the test setup and baseline images.

How do I turn a passing test into the new reference baseline?

Run backstop approve after the test looks good. It updates the reference files with the results from the last test.

Can I use Docker to avoid cross-platform screenshot differences?

Yes, BackstopJS has integrated Docker rendering to eliminate cross-platform rendering shenanigans.

Can BackstopJS simulate user interactions before taking screenshots?

Yes, it supports simulating user interactions with Playwright or Puppeteer scripts.

Answers sourced from github.com, github.com

Community

Collected 48 days ago - public community threads