graph
Graph dependencies within workspace
Usage
nx graph
Install nx globally to invoke the command directly using nx, or use npx nx, yarn nx, or pnpm nx.
Examples
Open the project graph of the workspace in the browser:
nx graph
Save the project graph into a json file:
nx graph --file=output.json
Generate a static website with project graph into an html file, accompanied by an asset folder called static:
nx graph --file=output.html
Show the graph where every node is either an ancestor or a descendant of todos-feature-main:
nx graph --focus=todos-feature-main
Include project-one and project-two in the project graph:
nx graph --include=project-one,project-two
Exclude project-one and project-two from the project graph:
nx graph --exclude=project-one,project-two
Show the graph where every node is either an ancestor or a descendant of todos-feature-main, but exclude project-one and project-two:
nx graph --focus=todos-feature-main --exclude=project-one,project-two
Watch for changes to project graph and update in-browser:
nx graph --watch
Options
affected
Type: boolean
Highlight affected projects
base
Type: string
Base of the current branch (usually main)
exclude
Type: string
Exclude certain projects from being processed
file
Type: string
Output file (e.g. --file=output.json or --file=dep-graph.html)
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
focus
Type: string
Use to show the project graph for a particular project and every node that is either an ancestor or a descendant.
groupByFolder
Type: boolean
Group projects by folder in the project graph
head
Type: string
Latest commit of the current branch (usually HEAD)
help
Type: boolean
Show help
host
Type: string
Bind the project graph server to a specific ip address.
open
Type: boolean
Default: true
Open the project graph in the browser.
port
Type: number
Bind the project graph server to a specific port.
targets
Type: string
The target to show tasks for in the task graph
uncommitted
Type: boolean
Uncommitted changes
untracked
Type: boolean
Untracked changes
version
Type: boolean
Show version number
view
Type: string
Choices: [projects, tasks]
Default: projects
Choose whether to view the projects or task graph
watch
Type: boolean
Default: false
Watch for changes to project graph and update in-browser