run
Run a target for a project (e.g., nx run myapp:serve:production).
You can also use the infix notation to run a target: (e.g., nx serve myapp --configuration=production)
You can skip the use of Nx cache by using the --skip-nx-cache option.
Usage
❯
nx run [project][:target][:configuration] [_..]
Install nx
globally to invoke the command directly using nx
, or use npx nx
, yarn nx
, or pnpm nx
.
Examples
Run the target build for the myapp project:
❯
nx run myapp:build
Run the target build for the myapp project, with production configuration:
❯
nx run myapp:build:production
Preview the task graph that Nx would run inside a webview.:
❯
nx run myapp:build --graph
Save the task graph to a file.:
❯
nx run myapp:build --graph=output.json
Print the task graph to the console.:
❯
nx run myapp:build --graph=stdout
Run's a target named build:test for the myapp project. Note the quotes around the target name to prevent "test" from being considered a configuration.:
❯
nx run myapp:"build:test"
Options
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
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. Pass "stdout" to print the results to the terminal.
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, compact]
Defines how Nx emits outputs tasks logs
parallel
Type: string
Max number of parallel processes [default is 3]
project
Type: string
Target project
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
verbose
Type: boolean
Prints additional information about the commands (e.g., stack traces)
version
Type: boolean
Show version number