node package manager
It’s your turn. Help us improve JavaScript. Take the 2017 JavaScript Ecosystem Survey »


Grunt Release It!

Interactive release tool for Git repositories. Options: run build command first, release to distribution repository (or branch), create GitHub release, publish to npm.

Automatically bump version, commit, tag, push, done.

This is the Grunt plugin of Release It!

Getting Started

This plugin requires Grunt ~0.4.2

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-release-it --save-dev

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


The "release-it" task

See Release It! for configuration options.


In your project's Gruntfile, add a section named release-it to the data object passed into grunt.initConfig(). These are some of the options with their default values:

    'release-it': {
        options: {
            pkgFiles: ['package.json'],
            commitMessage: 'Release %s',
            tagName: '%s',
            tagAnnotation: 'Release %s',
            buildCommand: false


Release a new patch (increments from e.g. 1.0.4 to 1.0.5):

grunt release-it

Release a patch, minor, major, or specific version:

grunt release-it:minor
grunt release-it:0.8.3
grunt release-it:2.0.0-rc.3

Make sure to check out the main Release It documentation to learn about all the options and features.

Translated options

The following Grunt options are passed on to Release It:

Grunt option Release-It! option
--no-write --dry-run
-v/--verbose same
-f/--force same
-d/--debug same