affected

Run target for affected projects

Usage

โฏ

nx affected

Install nx globally to invoke the command directly using nx, or use npx nx, yarn nx, or pnpm nx.

Examples

Run custom target for all affected projects:

โฏ

nx affected -t custom-target

Run tests in parallel:

โฏ

nx affected -t test --parallel=5

Run lint, test, and build targets for affected projects. Requires Nx v15.4+:

โฏ

nx affected -t lint test build

Run tests for all the projects affected by changing the index.ts file:

โฏ

nx affected -t test --files=libs/mylib/src/index.ts

Run tests for all the projects affected by the changes between main and HEAD (e.g., PR):

โฏ

nx affected -t test --base=main --head=HEAD

Run tests for all the projects affected by the last commit on main:

โฏ

nx affected -t test --base=main~1 --head=main

Run build for only projects with the tag dotnet:

โฏ

nx affected -t=build --exclude='*,!tag:dotnet'

Use the currently executing project name in your command.:

โฏ

nx affected -t build --tag=$NX_TASK_TARGET_PROJECT:latest

Options

all

Type: boolean

Deprecated: Use nx run-many instead

base

Type: string

Base of the current branch (usually main)

batch

Type: boolean

Default: false

Run task(s) in batches for executors which support batches

configuration

Type: string

This is the configuration to use when performing tasks on projects

exclude

Type: string

Exclude certain projects from being processed

files

Type: string

Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas or spaces

graph

Type: string

Show the task graph of the command. Pass a file path to save the graph data instead of viewing it in the browser.

Type: string

Latest commit of the current branch (usually HEAD)

help

Type: boolean

Show help

nxBail

Type: boolean

Default: false

Stop command execution after the first failed task

nxIgnoreCycles

Type: boolean

Default: false

Ignore cycles in the task graph

output-style

Type: string

Choices: [dynamic, static, stream, stream-without-prefixes]

Defines how Nx emits outputs tasks logs

parallel

Type: string

Max number of parallel processes [default is 3]

runner

Type: string

This is the name of the tasks runner configured in nx.json

skipNxCache

Type: boolean

Default: false

Rerun the tasks even when the results are available in the cache

targets

Type: string

Tasks to run for affected projects

uncommitted

Type: boolean

Uncommitted changes

untracked

Type: boolean

Untracked changes

verbose

Type: boolean

Prints additional information about the commands (e.g., stack traces)

version

Type: boolean

Show version number