BackstopJS
github.com
- Free plan
- macOS
- Linux
- Self-hosted
What BackstopJS is
BackstopJS is a free, MIT-licensed tool for checking visual changes in web apps by comparing screenshots over time. Its browser report lets users inspect reference images, test captures, and visual differences; CLI and JUnit reports are also available. It supports Puppeteer and Playwright, with Playwright able to use Chromium, Firefox, or WebKit. Scenarios can script clicks, scrolling, hovering, key presses, and cookie state. Captures can cover a full document, viewport, or selected DOM elements at configured viewport sizes. The documented workflow uses `backstop init` to configure tests, `backstop test` to compare captures, and `backstop approve` to update reference images. Installation through npm is available globally or locally, either as a standalone CLI or for use from a Node.js app. The README describes JUnit reporting for CI and integrations with build systems such as Jenkins, Travis, and gulp. A Docker option is intended to reduce rendering differences across environments, but Chrome Headless in Docker needs substantial memory and may otherwise time out. The repository README says the project needs a new maintainer or owner.
Who it suits
BackstopJS suits developers who want screenshot comparisons in web-app workflows and can work with an npm-installed tool. It may also fit teams using JUnit reporting or the listed build-system integrations.
Good to know, and what to watch
- Free and MIT licensed
- Supports Puppeteer and Playwright
- Captures full documents, viewports, or selected elements
- Provides browser, CLI, and JUnit reports
- Docker option aims to reduce rendering differences
- Chrome Headless in Docker needs substantial memory
- README says the project needs a new maintainer or owner
Plans
Every plan and priceBackstopJS
Free plan
The verdict
BackstopJS offers configurable screenshot comparisons and reporting without a listed software charge. Consider the Docker memory warning and the repository’s stated need for a maintainer when assessing its fit.
What the maker publishes
- Browser engines
- It supports Puppeteer and Playwright, with Playwright supporting Chromium, Firefox, or WebKit. source
- Capture targeting
- It can capture the full document, viewport, or selected DOM elements at configured viewport sizes. source
- Installation
- It can be installed globally or locally with npm, used as a standalone CLI, or required from a Node.js app. source
- Integrations
- The README describes CI reporting in JUnit format and integration with build systems such as Jenkins, Travis, and gulp. source
- Interactions
- Scenarios can simulate actions such as clicks, scrolling, hovering, key presses, and cookie state through scripts. source
- License
- GitHub identifies the project as MIT licensed. source
- Limit
- The README notes that Chrome Headless in Docker needs substantial memory and may otherwise produce timeout errors. source
- Maintenance
- The repository README says BackstopJS needs a new maintainer or owner. source
- Purpose
- BackstopJS automates visual regression testing of web apps by comparing screenshots over time. source
- Rendering consistency
- A Docker option runs tests in a BackstopJS container to reduce rendering differences across environments. source
- Reports
- It provides an in-browser report with reference, test, and visual-difference inspection, plus CLI and JUnit reports. source
- Security
- The README recommends matching the Docker container user to the local environment to improve security and avoid file ownership problems. source
- Workflow
- Its documented workflow uses `backstop init`, `backstop test`, and `backstop approve` to configure tests, compare screenshots, and update reference images. source
Checked against the maker's pages on 3 Oct 2026.