Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Deploy to using Grunt
branch: master


Perform common Divshot commands using Grunt.

See Divshot docs for documentation and details about options and how to configure your app.

Getting Started

This plugin requires Grunt ~0.4.1

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-divshot --save-dev

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


The "divshot" task


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

  divshot: {
    server: {
      options: {


By default, grunt-divshot will read your configurations from your divshot.json file. If no file is provided, the defaults will be used.

Each of these options are, well, optional. Any values provided will override any configurations you have in your divshot.json file.


Type: Boolean Default value: true

Once grunt's tasks have completed, the web server stops. This behavior can be changed with the keepAlive option


Type: Number Default value: 3474

The port number to run the server on


Type: String Default value:

The hostname to run the server at


Type: String Default value: ./

The relative path the the directory to run the server out of


Type: Boolean Default value: false

Force server to write clean urls for .html files


Type: Object Default value: {}

Key/value pairs of glob to path routing


Type: Object Default value: {}

Key/value pairs of glob to path cache control settings


Type: Object Default value: {}

Key/value paris of globs that describe various redirects within your app

Deploying to Divshot with Grunt

grunt-divshot lets you deploy to any environment that is available to you on Divshot (i.e. production, staging, etc.)


In your project's Gruntfile, add a section named any of the above tasks.

'divshot:push': {
  production: {
    // options
  staging: {
     // options

The values in your divshot.json file are the values that will configure your app on the Divshot hosting servers. If you have any special configuration in your Gruntfile.js under server, you'll need to add those values to your divshot.json file in order to see their effects on Divshot.



type: String Default value: null

Optionally override your user access token. Useful for build and deploy environments.

Each corresponds the features available in the divshot-cli


type: Array Default value: []

Array of globs of files or directories to exclude on deploy

Something went wrong with that request. Please try again.