summaryrefslogtreecommitdiff
path: root/plugins/git-commit/README.md
blob: dc10d8ad5cebd5a8b3311afcb0ead3922e86ef7a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# git-commit plugin

The git-commit plugin adds several [git aliases](https://www.git-scm.com/docs/git-config#Documentation/git-config.txt-alias) for [conventional commit](https://www.conventionalcommits.org/en/v1.0.0/#summary) messages.

To use it, add `git-commit` to the plugins array in your zshrc file:

```zsh
plugins=(... git-commit)
```

## Syntax

```zshrc
git <type> [(-s, --scope) "<scope>"] "<message>"
```

> ⚠️ Single/Double quotes around the scope and message are required

Where `type` is one of the following:

- `build`
- `chore`
- `ci`
- `docs`
- `feat`
- `fix`
- `perf`
- `refactor`
- `revert`
- `style`
- `test`

## Examples

`git style "remove trailing whitespace"` -> `git commit -m "style: remove trailing whitespace"`  
`git fix -s "router" "correct redirect link"` -> `git commit -m "fix(router): correct redirect link"`