# git-commit-template

**Repository Path**: mirrors_amzn/git-commit-template

## Basic Information

- **Project Name**: git-commit-template
- **Description**: Set commit templates for git
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# git-commit-template

![npm
publish](https://github.com/amzn/git-commit-template/workflows/publish/badge.svg)
![changelog](https://github.com/amzn/git-commit-template/workflows/changelog/badge.svg)

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.

## Install

For installing this plugin you need [husky](https://github.com/typicode/husky)
`>= 1.x`. Use npm to install this plugin to your package:

```bash
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:

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

## `git-commit-template` command

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`](.commit-msg) file to see the default
configuration added by us.

Sample for providing file name:

```javascript
// .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`).

## License

This library is licensed under the Apache 2.0 License.