affected
Run target for affected projects
Usage
nx affectedInstall nx globally to invoke the command directly using nx, or use npx nx, yarn nx, or pnpx nx.
Examples
Run custom target for all affected projects:
nx affected --target=custom-targetRun tests in parallel:
nx affected --target=test --parallel=5Run the test target for all projects:
nx affected --target=test --allRun tests for all the projects affected by changing the index.ts file:
nx affected --target=test --files=libs/mylib/src/index.tsRun tests for all the projects affected by the changes between main and HEAD (e.g., PR):
nx affected --target=test --base=main --head=HEADRun tests for all the projects affected by the last commit on main:
nx affected --target=test --base=main~1 --head=mainOptions
all
All projects
base
Base of the current branch (usually main)
configuration
This is the configuration to use when performing tasks on projects
exclude
Default: ``
Exclude certain projects from being processed
files
Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas
head
Latest commit of the current branch (usually HEAD)
help
Show help
only-failed
Default: false
Deprecated: The command to rerun failed projects will appear if projects fail. This now does nothing and will be removed in v15.
Isolate projects which previously failed
parallel
Max number of parallel processes [default is 3]
runner
This is the name of the tasks runner configured in nx.json
skip-nx-cache
Default: false
Rerun the tasks even when the results are available in the cache
target
Task to run for affected projects
uncommitted
Uncommitted changes
untracked
Untracked changes
verbose
Print additional error stack trace on failure
version
Show version number