An open API service indexing awesome lists of open source software.

https://github.com/samturrell/gitprefix


https://github.com/samturrell/gitprefix

Last synced: 11 months ago
JSON representation

Awesome Lists containing this project

README

          

# Gitprefix

Gitprefix is a Git `prepare-commit-msg` hook for formatting Git commit messages.

## Features

- Automatic task branch prefix (`task/`, `epic/`)
- Emoji prefixing for certain words:
- `fix`: 🔧
- `wip`: 🚧
- `bug`: 🐛
- `refactor`: 🔨
- `revert`: ⏪
- `pr`: 👌
- `initial commit`: 🎉
- `responsive`: 📱
- `accessibility`: ♿️

## Usage

### Prerequisites

You need to have a git template directory set up. You can do this by creating an
empty directory and adding this config to your `~/.gitconfig`:

```ini
[init]
templatedir = ~/path/to/your/git-template
```

### Installation

This package is used as an installer for the formatter. To install you can run the following command:

```sh
npx gitprefix install
```

For new git repositories, the hook files wil be added automatically, however for existing projects you can run the following commands to reinitialise:

```sh
npx gitprefix init
```

### Updating

If the package is ever updated you can run the following command to pull down the new formatter and overwrite the existing file:

```sh
npx gitprefix install --overwrite
```