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
Print the project graph as JSON to the console:
❯
nx graph --print
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
Option | Type | Description |
---|---|---|
--affected | boolean | Highlight affected projects. |
--base | string | Base of the current branch (usually main). |
--exclude | string | Exclude certain projects from being processed. |
--file | string | Output file (e.g. --file=output.json or --file=dep-graph.html). |
--files | string | Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas or spaces. |
--focus | string | Use to show the project graph for a particular project and every node that is either an ancestor or a descendant. |
--groupByFolder | boolean | Group projects by folder in the project graph. |
--head | string | Latest commit of the current branch (usually HEAD). |
--help | boolean | Show help. |
--host | string | Bind the project graph server to a specific ip address. |
--open | boolean | Open the project graph in the browser. (Default: true ) |
--port | number | Bind the project graph server to a specific port. |
--print | boolean | Print the project graph to stdout in the terminal. |
--targets | string | The target to show tasks for in the task graph. |
--uncommitted | boolean | Uncommitted changes. |
--untracked | boolean | Untracked changes. |
--verbose | boolean | Prints additional information about the commands (e.g., stack traces). |
--version | boolean | Show version number. |
--view | projects , tasks | Choose whether to view the projects or task graph. (Default: projects ) |
--watch | boolean | Watch for changes to project graph and update in-browser. (Default: true ) |