Git hooks (Husky + lint-staged)

Local quality gates for this monorepo:

Hook When What runs
pre-commit git commit lint-staged: Prettier write (restaged) + Nx-scoped ESLint --fix on staged files via scripts/lint-staged-nx.mjs
pre-push git push npm test (utilities + media-player build/test, then @tgmc/web Vitest)

Lint always includes Prettier, then Nx ESLint:

Script Prettier ESLint
npm run lint prettier -wl . (format) nx run-many -t lint (all packages with lint)
npm run lint:affected prettier -wl . (format) nx affected -t lint
npm run lint:staged / pre-commit prettier --write on staged files scripts/lint-staged-nx.mjs (Nx affected projects → ESLint --fix on staged paths)

Nx lint covers every project that defines a lint target (inferred via @nx/eslint): @tgmc/web, tgmc-web-layer-base, @tgmc/utilities, @tgmc/media-player, @tgmc/web-e2e.

Prettier does not execute on GitHub. eslint-plugin-prettier stays in the ESLint config; when GITHUB_ACTIONS=true, prettier/prettier is set to off so CI does not run Prettier. Formatting is enforced by husky/lint-staged and npm run format locally.

Line endings (LF only)

All text files use LF (\n), never CRLF:

Layer Setting
Prettier "endOfLine": "lf" in .prettierrc
EditorConfig end_of_line = lf in .editorconfig
Git .gitattributes → * text=auto eol=lf

On Windows, set the local clone (not global) so Git does not rewrite checkouts to CRLF:

git config core.autocrlf false
git config core.eol lf

If Prettier/ESLint report Delete ␍, renormalize once: git add --renormalize . then commit the line-ending-only changes (or run npm run format on the affected paths).

Setup

Hooks install automatically via the root prepare script (node scripts/husky-prepare.mjs) after local npm install.

GitHub Actions / CI: Husky is not used. scripts/husky-prepare.mjs skips when CI, GITHUB_ACTIONS, or HUSKY=0 is set; workflows set HUSKY=0 so npm ci and bot commits never install or run hooks.

npm install
# equivalent: npm run prepare

Skip hooks for a single local command when needed:

HUSKY=0 git commit -m "..."
HUSKY=0 git push

Manual runs

# Same as pre-commit (against currently staged files)
npm run lint:staged

# Prettier (whole repo) + lint all Nx packages with a lint target
npm run lint

# Prettier (whole repo) + lint projects affected by the working tree
npm run lint:affected

# Format only
npm run format

# Same as pre-push
npm test

Config