backstopjs shim for grunt
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


BackstopJs Shim for Grunt

Getting Started

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-backstop --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:



  • Provides a way to setup BackstopJS off of an initial npm or bower install without needing to access node_modules or bower_components

  • Mirrors tests and reference files to a separate, user defined tests folder, which can easily be check into the repository.

  • Run backstop commands from the project root using grunt

  • Allows you to easily integrate BackstopJS tests into build or CI workflows.


In your project's Gruntfile, add a section named backstop to the data object passed into grunt.initConfig().

  backstop: {
    your_target: {
      options: {
        backstop_path: './bower_components/backstopjs',
        test_path: './tests',
        setup: true,
        configure: true,
        create_references: true,
        run_tests: true


Type: String

Identifies the location of the BackstopJs module (usually bower_components or node_modules)


Type: String

Identifies the location of the directory that will contain your tests


Type: Boolean

When true, the target will trigger an npm install inside of the backstop_path.


Type: Boolean

When true, the target will copy the checked in reference files in your test_path into the backstop_path


Type: Boolean

When true, the target will create new backstopJS references and mirror them to the test_path


Type: Boolean

When true, the target will run the css regression tests

Usage Notes

You may configure your targets to run as many of the available options, and in any combination you like. However, they are setup to be run in a series as such:

  1. setup
  2. configure
  3. create references
  4. test

Release Notes

0.1.3 - provide sane default options


  • Create a stop command (The server has a 15 minute time out when you run the tests)

  • Add tests