Do I still need lint-staged when using oxfmt and Husky?

[raayonsh]

In one of the projects I've worked on, I used Husky alongside lint-staged to format code with Bun, Biome, and Prettier using the following setup:

.husky/pre-commit

bunx lint-staged

package.json

"lint-staged": {
  "**/*.{md,mdx}": "prettier --write",
  "**/*.{css,js,jsx,ts,tsx,cjs,mjs,json}": "biome check --write --unsafe"
}

I am planning to switch to oxfmt for a new project. How should I set this up, and do I still need both Husky and lint-staged? I've noticed different approaches in both Husky and lint-staged's official repositories.

[ryux1]

You do not strictly need all three, but they have separate jobs:

• Husky runs the Git pre-commit hook.
• lint-staged selects only staged paths and handles their edits safely.
• Oxfmt formats the paths it receives.

For a Bun project, I would keep Husky + lint-staged and replace the formatter configuration with Oxfmt:

bun add -d husky lint-staged oxfmt
bunx husky init

# .husky/pre-commit
bunx lint-staged

{
  "scripts": {
    "prepare": "husky",
    "fmt": "oxfmt",
    "fmt:check": "oxfmt --check"
  },
  "lint-staged": {
    "*": "oxfmt --no-error-on-unmatched-pattern"
  }
}

The * matcher is intentional: lint-staged passes staged paths, Oxfmt formats the languages it supports, and --no-error-on-unmatched-pattern avoids failing a commit containing only unsupported files. This is also the setup currently documented by Oxfmt.

You can remove lint-staged and build the staged-file list directly in the shell hook, as Husky documents, but then you own filename quoting, filtering, re-staging, and partially staged-file behavior. Keeping lint-staged is usually worth that small dependency unless your hook is deliberately minimal.

One migration caveat: Oxfmt replaces Prettier/formatting, not Biome lint rules. If biome check --write --unsafe was also fixing lint findings, retain a separate staged Biome/Oxlint command for the file types you want linted, or enforce linting in CI. Also keep oxfmt --check in CI because local hooks can be skipped with --no-verify.

References:

• Oxfmt pre-commit setup: https://oxc.rs/docs/guide/usage/formatter/ci#pre-commit-hook
• Husky staged-file example and tradeoff: https://typicode.github.io/husky/get-started.html#scripting