Skip to content

DOCS.md

Latest commit

 

History

History
76 lines (57 loc) · 2.22 KB

DOCS.md

File metadata and controls

76 lines (57 loc) · 2.22 KB
Raw

Documentation

Supported hooks

husky supports all Git hooks defined here.

Server-side hooks (pre-receive, update and post-receive) aren't supported.

Access Git params and stdin

Git hooks can get parameters via command-line arguments and stdin. Husky makes them accessible via HUSKY_GIT_PARAMS and HUSKY_GIT_STDIN environment variables.

{
  "husky": {
    "hooks": {
      "commit-msg": "echo $HUSKY_GIT_PARAMS"
    }
  }
}

Disable auto-install

If you don't want husky to automatically install Git hooks, simply set HUSKY_SKIP_INSTALL environment variable to true.

HUSKY_SKIP_INSTALL=true npm install

Multi-package repository (monorepo)

If you have a multi-package repository, it's recommended to use tools like lerna and have husky installed ONLY in the root package.json to act as the source of truth.

Generally speaking, you should AVOID defining husky in multiple package.json, as each package would overwrite previous husky installations.

.
└── root
    ├── .git
    ├── package.json 🐶 # Add husky here
    └── packages
        ├── A
        │   └── package.json
        ├── B
        │   └── package.json
        └── C
            └── package.json
// root/package.json
{
  "private": true,
  "devDependencies": {
    "husky": "..."
  },
  "husky": {
    "hooks": {
      "pre-commit": "lerna run test"
    }
  }
}

Node version management

If you're on Windows, husky will simply use the version installed globally on your system.

For macOS and Linux users:

  • if you're running git commands in the terminal, husky will use the version defined in your shell PATH. So if you're a nvm user, husky will use the version that you've set with nvm.
  • if you're using a GUI client and nvm, it may have a different PATH and not load nvm, in this case the highest node version installed by nvm will usually be picked. You can also check ~/.node_path to see which version is used by GUIs and edit if you want to use something else.

Debug

It's basic for the moment, but you can use HUSKY_DEBUG=true to log debug messages.