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