Husky + lint-staged: Shared Hooks & Fast Linting

This is the industry standard setup for JavaScript/TypeScript projects.

Step 1: Install both packages.

Step 2: Initialize Husky and create pre-commit hook that runs lint-staged.

Step 3: Configure lint-staged in package.json.

Step 4: Add commit-msg hook for commitlint (optional).

Step 5: Add pre-push hook for running tests (optional).

Step 6: Commit everything — team members get hooks automatically on npm install.

# Complete setup — copy this for any new project

# Step 1: Install
npm install --save-dev husky lint-staged prettier eslint

# Step 2: Initialize Husky
npx husky init

# Step 3: Create pre-commit hook with lint-staged
echo "npx lint-staged" > .husky/pre-commit

# Step 4: Configure lint-staged in package.json
# Add this to your package.json:
# "lint-staged": {
#   "*.{js,ts}": ["eslint --fix", "prettier --write"],
#   "*.{json,md,css,html}": ["prettier --write"]
# }

# Step 5: Optional — add commit-msg hook for commitlint
echo "npx --no -- commitlint --edit \$1" > .husky/commit-msg

# Step 6: Optional — add pre-push hook for tests
echo "npm test" > .husky/pre-push

# Step 7: Commit everything
git add .husky/ package.json package-lock.json
git commit -m "chore: add Husky + lint-staged"

# Now your team workflow:
# 1. Developer clones repo
git clone https://github.com/team/project.git
cd project

# 2. npm install sets up hooks automatically
npm install
# husky - Git hooks installed

# 3. Developer commits — hooks run automatically!
echo "const x = 1" > app.js
git add app.js
git commit -m "feat: add app"
# ✔ Pre-commit hook runs lint-staged
# ✔ ESLint + Prettier run on app.js only
# ✔ Commit proceeds with clean code