simple-git-hooks

A tool that lets you easily manage git hooks

The package was recently renamed from simple-pre-commit. See Releases for the simple-pre-commit documentation.

• Zero dependency

• Easy to configure (one line in package.json)

• Lightweight*:

  Package	Unpacked size	With deps
  husky v4 4.3.8	53.5 kB	~1 mB
  husky v5 5.0.9	24.5 kB	24.5 kB
  pre-commit 1.2.2	~80 kB	~80 kB
  simple-git-hooks 2.2.0	10.1 kB	10.1 kB

Who uses simple-git-hooks?

The package is recommended by lint-staged

• Autoprefixer
• PostCSS
• Browserslist
• Nano ID
• Size Limit
• Storeon
• More, see full list

What is a git hook?

A git hook is a command or script that is going to be run every time you perform a git action, like git commit or git push.

If the execution of a git hook fails, then the git action aborts.

For example, if you want to run linter on every commit to ensure code quality in your project, then you can create a pre-commit hook that would call npx lint staged.

Check out lint-staged. It works really well with simple-git-hooks.

You can look up about git hooks on the Pro Git book.

When to use it

simple-git-hooks works well for small-sized projects when you need quickly set up hooks and forget about it.

However, this package requires you to manually apply the changes to git hooks. If you update them often, this is probably not the best choice.

Also, this package allows you to set only one command per git hook.

If you need multiple verbose commands per git hook, flexible configuration or automatic update of git hooks, please check out the other packages:

• Lefthook
• husky
• pre-commit

Usage

Add simple-git-hooks to the project

1. Install simple-git-hooks as a dev dependency:

   npm install simple-git-hooks --save-dev

2. Add simple-git-hooks to your package.json. Fill it with git hooks and the corresponding commands.

   For example:

   {
     "simple-git-hooks": {
       "pre-commit": "npx lint-staged",
       "pre-push": "cd ../../ && npm run format"
     }
   }

   This configuration is going to run all linters on every commit and formatter on push.

   There are more ways to configure the package. Check out Additional configuration options.

3. Run the CLI script to update the git hooks with the commands from the config:

   npx simple-git-hooks

Now all the git hooks are created.

Update git hooks command

1. Change the configuration.

2. Run npx simple-git-hooks from the root of your project.

Note for yarn2 users: Please run yarn dlx simple-git-hooks instead of the command above. More info on dlx

Note that you should manually run npx simple-git-hooks every time you change a command.

Additional configuration options

You can also add a .simple-git-hooks.js, simple-git-hooks.js, .simple-git-hooks.json or simple-git-hooks.json file to the project and write the configuration inside it.

This way simple-git-hooks configuration in package.json will not take effect any more.

.simple-git-hooks.js or simple-git-hooks.js should look like the following.

module.exports = {
  "pre-commit": "npx lint staged",
  "pre-push": "cd ../../ && npm run format"
}

.simple-git-hooks.json or simple-git-hooks.json should look like the following.

{
  "pre-commit": "npx lint staged",
  "pre-push": "cd ../../ && npm run format"
}

Uninstall simple-git-hooks

Uninstallation will remove all the existing git hooks.

npm uninstall simple-git-hooks