grunt-bump-cordova editorconfig npm

:fuelpump: Release management for cordova and ionic based applications.

3 years after


Bump package version, create tag, commit, push ...

Same as grunt-bump package but with cordova's config.xml support.

Getting Started

This plugin requires Grunt.

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-bump-cordova --save-dev

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



In your project's Gruntfile, add a section named bump to the data object passed into grunt.initConfig(). The options (and defaults) are:

  bump: {
    options: {
      files: ['package.json', 'bower.json', 'config.xml'],
      updateConfigs: [],
      commit: true,
      commitMessage: 'Release %VERSION%',
      commitFiles: ['package.json', 'bower.json', 'config.xml'],
      createTag: true,
      tagName: '%VERSION%',
      tagMessage: 'Version %VERSION%',
      push: true,
      pushTo: 'upstream',
      gitDescribeOptions: '--tags --always --abbrev=1 --dirty=-d',
      androidVersionCodeIncrement: 10



Type: Array Default value: ['package.json', 'bower.json', 'config.xml']

Maybe you wanna bump 'component.json' instead? Or maybe both: ['package.json', 'bower.json', 'config.xml', 'component.json']? Can be either a list of files to bump (an array of files) or a grunt glob ( eg: ['*.json'] ).


Type: Array Default value: []

Sometimes you load the content of package.json into a grunt config. This will update the config property, so that even tasks running in the same grunt process see the updated value.

bump: {
  files:         ['package.json', 'bower.json', 'config.xml', 'component.json'],
  updateConfigs: ['pkg']


Type: Boolean Default value: true

Should the changes be committed? False if you want to do additional things.


Type: String Default value: Release %VERSION%

If so, what is the commit message ? You can use %VERSION% which will get replaced with the new version.


Type: Array Default value: ['package.json', 'bower.json', 'config.xml']

An array of files that you want to commit. You can use ['-a'] to commit all files.


Type: Boolean Default value: true

Create a Git tag?


Type: String Default value: %VERSION%

If options.createTag is set to true, then this is the name of that tag (%VERSION% placeholder is available).


Type: String Default value: Version %VERSION%

If options.createTag is set to true, then yep, you guessed right, it's the message of that tag - description (%VERSION% placeholder is available).


Type: Boolean Default value: true

Push the changes to a remote repo?


Type: String Default value: upstream

If options.push is set to true, which remote repo should it go to?


Type: String Default value: --tags --always --abbrev=1 --dirty=-d

Options to use with $ git describe


Type: Integer Default value: 10

Increment android-versionCode in cordova config.xml by the value of options.androidVersionCodeIncrement

Usage Examples

Let's say current version is 0.0.1.

$ grunt bump
>> Version bumped to 0.0.2
>> Committed as "Release 0.0.2"
>> Tagged as "0.0.2"
>> Pushed to origin

$ grunt bump:patch
>> Version bumped to 0.0.3
>> Committed as "Release 0.0.3"
>> Tagged as "0.0.3"
>> Pushed to origin

$ grunt bump:minor
>> Version bumped to 0.1.0
>> Committed as "Release 0.1.0"
>> Tagged as "0.1.0"
>> Pushed to origin

$ grunt bump:major
>> Version bumped to 1.0.0
>> Committed as "Release 1.0.0"
>> Tagged as "1.0.0"
>> Pushed to origin

$ grunt bump:prerelease
>> Version bumped to 1.0.0-1
>> Committed as "Release 1.0.0-1"
>> Tagged as "1.0.0-1"
>> Pushed to origin

$ grunt bump:patch
>> Version bumped to 1.0.1
>> Committed as "Release 1.0.1"
>> Tagged as "1.0.1"
>> Pushed to origin

$ grunt bump:git
>> Version bumped to 1.0.1-ge96c
>> Committed as "Release 1.0.1-ge96c"
>> Tagged as "1.0.1-ge96c"
>> Pushed to origin

If you want to jump to an exact version, you can use the setversion tag in the command line.

$ grunt bump --setversion=2.0.1
>> Version bumped to 2.0.1
>> Committed as "Release 2.0.1"
>> Tagged as "v2.0.1"
>> Pushed to origin

Sometimes you want to run another task between bumping the version and commiting, for instance generate changelog. You can use bump-only and bump-commit to achieve that:

$ grunt bump-only:minor
$ grunt changelog
$ grunt bump-commit


See the contributing guide for more information. In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt: grunt test jshint.


Copyright (c) 2014 Alan Accurso. Licensed under the MIT license.

Related Repositories



Mustard - the Open Source Sonar Super Simulator ...

Top Contributors

vojtajina aaccurso eddiemonge jrobichaud elfreyshira jrabbe ajpiano MathiasPaumgarten halkeye geoah kuatsure adambiggs mfrancois MayhemYDG michaek mariomc RobinQu Snugug theodorton Tibo75 angleman CatTail ylesaout


-   v0.0.15 zip tar
-   v0.0.14 zip tar
-   v0.0.13 zip tar
-   v0.0.12 zip tar
-   v0.0.11 zip tar
-   v0.0.10 zip tar
-   v0.0.9 zip tar
-   v0.0.8 zip tar
-   v0.0.7 zip tar
-   v0.0.6 zip tar
-   v0.0.5 zip tar
-   v0.0.4 zip tar
-   v0.0.3 zip tar
-   0.1.7 zip tar
-   0.1.6 zip tar
-   0.1.5 zip tar
-   0.1.4 zip tar
-   0.1.3 zip tar
-   0.1.2 zip tar
-   0.1.1 zip tar