node package manager



Deploy files to any branch of any remote git repository.

Getting Started

This plugin requires Grunt ~0.4.1 and must be used with Git 1.8.3 or better (see Git changelog).

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-git-deploy --save-dev

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


The "git_deploy" task


The way this task works is it creates an empty git repository in the src directory you specify, creates an orphan branch and commits all files from that directory to it. Then it pushes the branch to the configured remote repository. Be careful as this destroys the history of the remote branch.

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

  git_deploy: {
    your_target: {
      options: {
        url: ''
      src: 'directory/to/deploy'



Type: String

The URL to a remote git repository. This option is required.


Type: String Default value: 'gh-pages'

The branch to push to.


Type: String Default value: 'autocommit'

Commit message.


Type: Boolean/String Default value: false

Whether to tag the release. Provide a tag name (string) to tag the release commit. To use the package version, first read the package.json

  pkg: grunt.file.readJSON("package.json")

and then pass the value '<%= pkg.version %>'


Type: String Default value: 'autocommit'

The message for the tag referenced above. This option is ignored if options.tag is false.


If you can think of a way to unit test this plugin please take a shot at it.