show
Show information about the workspace (e.g., list of projects).
Usage
โฏ
nx show
Install nx
globally to invoke the command directly using nx
, or use npx nx
, yarn nx
, or pnpm nx
.
Examples
Show all projects in the workspace:
โฏ
nx show projects
Show all projects with names starting with "api-". The "projects" option is useful to see which projects would be selected by run-many:
โฏ
nx show projects --projects api-*
Show all projects with a tag starting with "ui-". The "projects" option is useful to see which projects would be selected by run-many:
โฏ
nx show projects --projects tag:ui-*
Show all projects with a serve target:
โฏ
nx show projects --with-target serve
Show affected projects in the workspace:
โฏ
nx show projects --affected
Show affected apps in the workspace:
โฏ
nx show projects --affected --type app
Show affected projects in the workspace, excluding end-to-end projects:
โฏ
nx show projects --affected --exclude=*-e2e
If in an interactive terminal, opens the project detail view. If not in an interactive terminal, defaults to JSON:
โฏ
nx show project my-app
Show detailed information about "my-app" in a json format:
โฏ
nx show project my-app --json
Show information about "my-app" in a human readable format:
โฏ
nx show project my-app --json false
Opens a web browser to explore the configuration of "my-app":
โฏ
nx show project my-app --web
Options
Shared Option | Type | Description |
---|---|---|
--help | boolean | Show help. |
--json | boolean | Output JSON. |
--version | boolean | Show version number. |
Subcommands
projects
Show a list of projects in the workspace.
โฏ
nx show projects
Options
Option | Type | Description |
---|---|---|
--affected | boolean | Show only affected projects. |
--base | string | Base of the current branch (usually main). |
--exclude | string | Exclude certain projects from being processed. |
--files | string | Change the way Nx is calculating the affected command by providing directly changed files, list of files delimited by commas or spaces. |
--head | string | Latest commit of the current branch (usually HEAD). |
--help | boolean | Show help. |
--projects | string | Show only projects that match a given pattern. |
--sep | string | Outputs projects with the specified seperator. |
--type | app , lib , e2e | Select only projects of the given type. |
--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. |
--withTarget | string | Show only projects that have a specific target. |
project
Shows resolved project configuration for a given project.
โฏ
nx show project <projectName>
Options
Option | Type | Description |
---|---|---|
--help | boolean | Show help. |
--open | boolean | Set to false to prevent the browser from opening when using --web. |
--projectName | string | Which project should be viewed?. |
--verbose | boolean | Prints additional information about the commands (e.g., stack traces). |
--version | boolean | Show version number. |
--web | boolean | Show project details in the browser. (default when interactive). |