MIGRATION

v17

Node.js v20 is no longer supported.

The oldest supported Node.js version is now 22.22.1, which is the latest active v22 LTS version at the time of release. You can — of course — update to v24 or v25, or later.

The `yaml` dependency is now optional

The dependency yaml is now marked as optional and probably won't be installed by default. If you're using a YAML configuration file you should install the package separately:

shell

npm install --development yaml

If you're using .lintstagedrc as the config file name (without a file extension), it will be treated as a YAML file. If the content is JSON, consider renaming it to .lintstagedrc.json to avoid needing to install yaml.

Git version needs to be at least 2.32.0

Lint-staged now tries to verify the installed Git version is at least 2.32.0, released in 2021. If you're using an even older Git version, you need to upgrade it before running lint-staged!

v16

Updated Node.js version requirement

For version [email protected] the lowest supported Node.js version is 20.19.0, following requirements of nano-spawn. Please upgrade your Node.js version.

For version [email protected] this is lowered to 20.17.0, again following nano-spawn.

Removed validation for removed advanced configuration file options

Advanced configuration options (removed in v9) are no longer validated separately, and might be treated as valid globs for tasks. Please do not try to use advanced config options anymore, they haven't been supported since v8.

Removed the `--shell` option

The --shell flag has been removed and lint-staged no longer supports evaluating commands directly via a shell. To migrate existing commands, you can create a shell script and invoke it instead. Lint-staged will pass matched staged files as a list of arguments, accessible via "$@":

shell

# my-script.sh
#!/bin/bash

echo "Staged files: $@"

and

json

{ "*.js": "my-script.sh" }

If you were using the shell option to avoid passing filenames to tasks, for example bash -c 'tsc --noEmit', use the function syntax instead:

export default { '*.ts': () => 'tsc --noEmit' }

Processes are spawned using `nano-spawn`

Processes are spawned using nano-spawn instead of execa. If you are using Node.js scripts as tasks, you might need to explicitly run them with node, especially when using Windows: