Sets commit template for your git projects. This is a husky plugin which should be used on prepare-commit-msg hook exposed by git.

When we do git commits we usually follow a practice for the commit message, this package aims to streamline that practice by providing you a standard template to follow. It also enables you to set your own standard template. With this plugin setup, next time when you do git commit you will get the standard template for commit message set for you.

For installing this plugin you need husky >= 1.x. Use npm to install this plugin to your package:

npm i --save-dev git-commit-template husky@1

Note: We have tested the plugin with husky@1 but you can try with higher versions too if that works for you

It exposes a cli command with name git-commit-template which you can use in your husky configuration. For example:

// .huskyrc.js
module.exports = {
  hooks: {
    "prepare-commit-msg": "git-commit-template",
  },
};

This command takes an optional parameter of your commit message file name. If provided, then it will read the file provided by you, otherwise uses its default configuration file. Read .commit-msg file to see the default configuration added by us.

Sample for providing file name:

// .huskyrc.js
module.exports = {
  hooks: {
    "prepare-commit-msg": "git-commit-template .my-custom-git-msg-file",
  },
};

Note: This hooks provides you default commit message only if you haven't provided any yet. This means that this plugin will not add message if you are amending your commit(git commit --amend) or using interactive rebase (git rebase -i HEAD~3).

This library is licensed under the Apache 2.0 License.