Husky, Commitlint and lint-staged — DevFlow

Set up Husky pre-commit hooks, lint-staged, Commitlint and Commitizen in a Node.js or TypeScript project with one command.

Husky

Git hooks made easy — manages pre-commit, commit-msg, and pre-push hooks.

📖 Official Docs

ID: husky
Category: Git
Conflicts with: Lefthook

What it does

Installs husky as a dev dependency
Adds a prepare script (husky)
Creates .husky/pre-commit — runs npx lint-staged (or npm run lint)
Creates .husky/commit-msg — runs npx commitlint --edit "$1"

Options

Option	Type	Default	Description
`hooks`	`string[]`	`["pre-commit", "commit-msg"]`	Which hooks to configure
`withLintStaged`	`boolean`	`false`	Use lint-staged in pre-commit

Detection

Detected as already configured if .husky/pre-commit or .husky/_/husky.sh exists.

lint-staged

Run linters on staged files only — ensures only changed files are linted before commit.

📖 Official Docs

ID: lint-staged
Category: Git
Depends on: Husky

What it does

Installs lint-staged as a dev dependency
Adds lint-staged configuration to package.json
Configures glob patterns based on your stack (e.g., *.{ts,tsx} for TypeScript)

Commitlint

Enforce conventional commit messages — rejects commits that don't follow the Conventional Commits spec.

📖 Official Docs

ID: commitlint
Category: Git

What it does

Installs @commitlint/cli and @commitlint/config-conventional
Creates commitlint.config.mjs

Options

Option	Type	Default	Description
`mode`	`"strict" \| "loose"`	`"strict"`	Strict adds extra rules for type-enum, subject-case, header-max-length

Strict Mode Config

export default {
  extends: ["@commitlint/config-conventional"],
  rules: {
    "type-enum": [
      2,
      "always",
      [
        "feat",
        "fix",
        "docs",
        "style",
        "refactor",
        "perf",
        "test",
        "build",
        "ci",
        "chore",
        "revert",
      ],
    ],
    "subject-case": [2, "never", ["start-case", "pascal-case", "upper-case"]],
    "header-max-length": [2, "always", 100],
  },
};