The SunGard standard release script for HTML5 projects.

version: 0.2.4

This task provides a standard workflow for creating releases on git repositories. It extends the grunt-bump plugin task in order to provide some of the essential release steps. Getting to know both tasks will help a lot when you want to configure your custom releases.

First of all, 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.

In order to use this task you will need git installed and available as a system-wide command. npm and Bower are also required in order to validate HTML5 packages but you can disable this validation using the configurable options.

This release task was created to work with the Gitflow Workflow. If your Git repository is not using something similar, chances are that you do not should use this plugin.

Your Git repository will need to have both develop and master branches created and pushed to the remote server. Also, do not try to recreate existing versions, this will break grunt-bump release cycle.

Once you're familiar with all the requirements, you may install this plugin with this command:

npm install grunt-sg-release --save-dev

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

grunt.loadNpmTasks('grunt-sg-release');

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

grunt.initConfig({
  sg_release: {
    options: {
      skipBowerInstall: true,
      developBranch: 'develop',
      masterBranch: 'master',
      files: [
        'package.json',
        'README.md'
      ],
      commitMessage: 'Release v%VERSION%',
      commitFiles: ['-a'], // '-a' for all files
      pushTo: 'origin'
    }
  },
})

Type: Boolean Default value: false

Skip the execution of bower install command

Type: Boolean Default value: false

Skip the execution of npm install command

Type: String Default value: 'develop'

Name of the branch used as a "development branch" in your repository.

Type: String Default value: 'master'

Name of the branch used as a "master branch" in your repository.

Type: String Default value: 'release'

Name prefix of the branch used as a temporary release branch in your repository.

Type: String Default value: ''

Prefix to be added before the commit messages below. It's just an empty string by default. Also note that a space will be always added between the prefix and the message.

Type: String Default value: 'Merge into develop'

Commit message to be used when merging changes into the develop branch.

Type: String Default value: 'Merge into master'

Commit message to be used when merging changes into the master branch.

Type: String Default value: 'Increased version for development'

Commit message to be used in the development version update commit.

Type: String Default value: 'upstream'

Reference to the git remote repository to push to.

Additionally to all the available options listed above, all the grunt-bump options are available to be configured when using this task.

In this example all possible configurable values are listed with their default values inside the options property of sg_release task. Feel free to modify them inside your Gruntfile to better suit your project configuration.

grunt.initConfig({
  sg_release: {
    options: {
      // sg_release specific properties
      skipBowerInstall: false,
      skipBowerInstall: false,
      developBranch: 'develop',
      masterBranch: 'master',
      tempReleaseBranch: 'release',
      commitMessagePrefix: '',
      mergeToDevelopMsg: 'Merge into develop',
      mergeToMasterMsg: 'Merge into master',
      developVersionCommitMsg: 'Increased version for development',
      // pushTo and tagName are overlapped properties, used by both sg_release and grunt-bump
      pushTo: 'upstream',
      tagName: 'v%VERSION%',
      // grunt-bump specific options
      bumpVersion: true,
      files: ['package.json'],
      updateConfigs: [], // array of config properties to update (with files)
      commit: true,
      commitMessage: 'Release v%VERSION%',
      commitFiles: ['package.json'], // '-a' for all files
      createTag: true,
      tagMessage: 'Version %VERSION%',
      push: false, // push during the first bump phase is deactivated by default
      gitDescribeOptions: '--tags --always --abbrev=1 --dirty=-d'
    }
  }
})

When running the task you will be prompted to enter the release version number. Additionally, you will also be prompted to enter a version number to be used on the develop branch.

It is possible to specify a releaseVersion and developVersion on command line in order to skip these question and use the provided values when invoking the task. See the example below:

grunt sg_release --releaseVersion 1.0.0 --developVersion 1.0.1-rc

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.

Copyright (c) 2014 SunGard. Licensed under the MIT license.