Skip to content

A npm package to increase the developer experience and consistency by providing a set of hooks that can be opted-in the development lifecycle.

License

Notifications You must be signed in to change notification settings

jeliasson/npm-husky-hooks

Folders and files

NameName
Last commit message
Last commit date
Feb 24, 2025
May 25, 2022
May 25, 2022
Feb 24, 2025
Jun 3, 2022
May 31, 2022
May 25, 2022
Feb 24, 2025
Feb 24, 2025
Feb 24, 2025
Feb 24, 2025
May 25, 2022
Feb 24, 2025
Feb 24, 2025
May 25, 2022
Feb 24, 2025
Feb 24, 2025

Repository files navigation

@jeliasson/husky-hooks

NPM npm bundle size npm Libraries.io dependency status for latest release, scoped npm package GitHub issues

This npm package aims to increase the developer experience and consistency by providing a set of hooks that can be opted-in the development lifecycle. It depends on husky for pre-commit and pre-push hooks, and a few other zero/low dependency packages.

⚠️ Note: This package is in development and comes with breaking changes, so move with caution.

Setup

First, make sure you have husky installed. See installation here or refer to below quick setup.

# Install husky dependency
npm install --save--dev husky

# Install husky
npx husky install

Once you have husky installed, let's proceed with setting up @jeliasson/husky-hooks and connect it with husky's pre-commit and pre-push hooks.

# Install dependency @jeliasson/husky-hooks
npm install -save--dev @jeliasson/husky-hooks

# Add package pre-commit hook
npx husky add .husky/pre-commit "npx @jeliasson/husky-hooks pre-commit"

# Add package pre-push hook
npx husky add .husky/pre-push "npx @jeliasson/husky-hooks pre-push"

Now to create a config file. husky-hooks.config.js will be placed in the root folder of the project.

# Create config
npx @jeliasson/husky-hooks create-config

Let's test it out and see if we get some magic ✨

# Make a new branch, create a test file, git add and commit
git checkout -b testing/jeliasson-husky-hooks
touch test.tmp && git add test.tmp
git commit -m "test(repo): keep calm and commit"

This should yield the following output...

Running hook test-sleep... ✅
Running hook check-branch... ✅
Running hook check-lock-files... ✅
Running hook run with argument 'echo Test'... ✅

...unless you have anything other than package-lock.json in your repo 😅

Running hook test-sleep... ✅
Running hook check-branch... ✅
Running hook check-lock-files... ❌

Invalid occurence of "yarn.lock" file. Remove it and only use "package-lock.json"

Hooks

Hooks to run is defined in the configuration file husky-hooks.config.js that was created as part of the setup. Below is a table of available built-in hooks, followed by it's respective specific configuration. Future hooks may be created that require additional dev dependencies, not included in this package, but those will be marked.

Name Description
check-branch Check which git branch we're currently on, and abort if it's a protected branch.
check-lock-files Check for package manager lock files, and abort if any are present lock file that we don't want.
run-cmd Run a ad-hoc command, and abort if the commands fails.

check-branch

Check which git branch we're currently on, and abort if it's a protected branch. This can be useful to make sure that commits stay away from branches that only being used for Pull Requests or CI/CD.

Setup

Add check-branch hook to pre-commit and/or pre-push.

{
  hooks: {
    'pre-commit': [
      'check-branch', /* This line */
      ...
    ],

    'pre-push': [
      'check-branch', /* This line */
      ...
    ],
  },
}

Settings

{
  settings: {
    'check-branch': {
      // Git branches that should be protected from accidental commit or push
      protectedBranches: ['main', 'dev'],
    },
  }
}

check-lock-files

Check for package manager lock files, and abort if any are present lock file that we don't want. This is useful to ensure that e.g. only package-lock.json is present in the repository.

Setup

Add check-lock-files hook to pre-commit and/or pre-push.

{
  hooks: {
    'pre-commit': [
      'check-lock-files', /* This line */
      ...
    ],

    'pre-push': [
      'check-lock-files', /* This line */
      ...
    ],
  },
}

Settings

{
  settings: {
    'check-lock-files': {
      // Package manager lock file that should be present in the repository
      allowLockFile: 'package-lock.json',

      // Package manager lock files that should yield a abort
      denyLockFiles: ['yarn.lock', 'pnpm-lock.yaml'],
    },
  }
}

run-cmd

Run a ad-hoc command, for example npm run lint, and abort if the commands fails. This can be useful if you have other commands, for exmaple in your husky hooks, that you want to run as part of this package.

⚠️ Note: Still figuring out the best approach to capture stdout/stderr and present them where appropriate. It works fine for now.

Setup

Add run-cmd hooks to pre-commit and/or pre-push. It should be shaped as an array where the first argument is run-cmd and the second argument would be the command to run, e.g. npm run lint. In below example we have two ad-hoc commands for each hook.

{
  hooks: {
    'pre-commit': [
      ['run-cmd', 'echo This is a pre-commit hook via run-cmd'],
      ['run-cmd', 'npm run lint'],
      ...
    ],

    'pre-push': [
      ['run-cmd', 'echo This is a pre-push hook via run-cmd'],
      ['run-cmd', 'npm run lint'],
      ...
    ],
  },
}

Other

Print output

Sometimes you may want to print the actual output of a hook, and passing --stdout will print the stdout of all hooks.

npx @jeliasson/husky-hooks pre-commit --stdout

Development

Prerequisites

  • NodeJS >= 20.18.3
  • npm >= 10.8.2

From the package directory, run

npm link

Start tsc watch

npm run dev

From the test project directory, run

npm link @jeliasson/husky-hooks

Todo

See Issues

Contributing

See CONTRIBUTING ❤️