setup-pre-commit

Install husky, lint-staged, and prettier as devDependencies, then run npx husky init to create the .husky directory. Write a .husky/pre-commit file that runs lint-staged, typecheck, and test scripts, and add a .lintstagedrc for staged-file formatting.

Use lint-staged with a .lintstagedrc containing {"*": "prettier --ignore-unknown --write"}. The pre-commit hook runs npx lint-staged, which applies Prettier only to files staged in Git, keeping commits fast.

Yes, Husky works with any package manager. Detect the package manager from lockfiles (pnpm-lock.yaml, yarn.lock, bun.lockb) and adapt the hook commands accordingly, replacing npm with the detected tool in the pre-commit script.

Common causes include a missing prepare script in package.json (it must be "husky"), a non-executable .husky/pre-commit file, or Husky not being initialized. Run npx husky init and verify the hook file exists and is executable.

Omit those lines from the .husky/pre-commit file and inform the user. The hook should only reference scripts that actually exist in package.json, otherwise every commit will fail with a missing-script error.