HaloStack Docs
Open App
Tools

Husky

The Husky hook directory that mechanically enforces formatting and typechecking on every commit.

tools/husky is Husky's hook directory — the set of git hooks Husky installs into the repo. It is not a workspace package (there's no package.json), just the hook files themselves. It's wired up from the repo root package.json via the prepare script: "prepare": "husky tools/husky".

Hooks

The directory currently defines a single hook, which runs before every commit:

  • pre-commit runs bunx lint-staged (Biome check --write --unsafe on staged *.{js,jsx,ts,tsx,json,jsonc,css} files), then bun run typecheck across the workspace. If either step fails, the commit fails.

Conventions

Keep hooks fast — they run on every commit. To add a new hook, drop a file into this directory (for example pre-push); Husky picks it up after the next prepare.

These hooks are what mechanically enforce the repo's "never commit unformatted code, never skip typecheck" rules, so for real work don't bypass them with --no-verify.

On This Page