BackstopJS
BackstopJS is a visual regression testing tool that compares website screenshots before and after code changes to help developers catch unintended layout or…
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.
Security check: 1 serious finding
- Uses basic-ftp 5.0.4, which has a known critical vulnerability (npm)
Automated checks on commit a11d365, 17 Oct 2026. Not an audit.
- 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
Variants
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
- Can't run BackstopJS interactive reporting - Stack Overflow (forum)
- Wait until page is fully loaded in BackstopJS - Stack Overflow (forum)
- Scaling BackstopJS help : r/softwaretesting - Reddit (reddit)
- BackstopJS Users? : r/QualityAssurance - Reddit (reddit)
- Backstopjs site loading issue not solved by delay: what is wrong? (forum)
Collected 48 days ago - public community threads