83a387a105
Creates a [custom landing page for Nx commands](https://nx-dev-git-docs-commands-landing-page-nrwl.vercel.app/reference/nx-commands)
320 lines
7.8 KiB
Markdown
320 lines
7.8 KiB
Markdown
# Nx Commands
|
|
|
|
The Nx CLI provides many commands. They are organized here into commands that:
|
|
|
|
- [Modify Code](#modify-code)
|
|
- [Run Tasks](#run-tasks)
|
|
- [Display Information](#display-information)
|
|
|
|
There is also a section for separate commands that can [create a new Nx workspace](#create-commands) for you.
|
|
|
|
{% callout type="note" title="Parsing Nx Commands" %}
|
|
|
|
If the command that you pass to Nx is not one of the keywords listed below, it will try to interpret the command as if it were a task. So Nx will parse your command in the following ways and execute the first syntax that is valid.
|
|
|
|
1. `nx [built-in-command] [...arguments]`
|
|
2. `nx [task-name-for-root-project] [...arguments]`
|
|
3. `nx [task-name] [project-name] [...arguments]`
|
|
|
|
{% /callout %}
|
|
|
|
## Modify Code
|
|
|
|
These commands modify your codebase in some way.
|
|
|
|
### init
|
|
|
|
Adds Nx to any type of workspace. It installs nx, creates an `nx.json` configuration file and optionally sets up remote caching.
|
|
|
|
```shell
|
|
nx init
|
|
```
|
|
|
|
{% cards cols="2" mdCols="4" smCols="2" %}
|
|
|
|
{% link-card title="nx init" type="API Reference" url="/nx-api/nx/documents/init" /%}
|
|
{% link-card title="Add to Existing Monorepo" type="Recipe" url="/recipes/adopting-nx/adding-to-monorepo" /%}
|
|
{% link-card title="Add to Any Project" type="Recipe" url="/recipes/adopting-nx/adding-to-existing-project" /%}
|
|
{% link-card title="Migrate from Angular CLI" type="Recipe" url="/recipes/angular/migration/angular" /%}
|
|
|
|
{% /cards %}
|
|
|
|
### add
|
|
|
|
Install a plugin and initialize it.
|
|
|
|
```shell
|
|
nx add my-plugin
|
|
```
|
|
|
|
{% cards %}
|
|
|
|
{% link-card title="nx add" type="API Reference" url="/nx-api/nx/documents/add" /%}
|
|
{% link-card title="Plugin Registry" type="Reference" url="/plugin-registry" /%}
|
|
|
|
{% /cards %}
|
|
|
|
### generate
|
|
|
|
Runs a generator that creates and/or modifies files based on a generator from a plugin.
|
|
|
|
```shell
|
|
nx generate @nx/react:component my-component
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx generate" type="API Reference" url="/nx-api/nx/documents/generate" /%}
|
|
{% link-card title="Generate Code" type="Feature" url="/features/generate-code" /%}
|
|
{% /cards %}
|
|
|
|
### migrate
|
|
|
|
Creates a migrations file or runs migrations from the migrations file.
|
|
|
|
```shell
|
|
nx migrate latest
|
|
nx migrate --run-migrations
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx migrate" type="API Reference" url="/nx-api/nx/documents/migrate" /%}
|
|
{% link-card title="Automate Updating Dependencies" type="Feature" url="/features/automate-updating-dependencies" /%}
|
|
{% /cards %}
|
|
|
|
### repair
|
|
|
|
Repair any configuration that is no longer supported by Nx.
|
|
|
|
Specifically, this will run every migration within the nx package against the current repository. Doing so should fix any configuration details left behind if the repository was previously updated to a new Nx version without using nx migrate.
|
|
|
|
If your repository has only ever updated to newer versions of Nx with nx migrate, running nx repair should do nothing.
|
|
|
|
```shell
|
|
nx repair
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx repair" type="API Reference" url="/nx-api/nx/documents/repair" /%}
|
|
{% /cards %}
|
|
|
|
### connect
|
|
|
|
Connect an Nx workspace to Nx Cloud
|
|
|
|
```shell
|
|
nx connect
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx connect" type="API Reference" url="/nx-api/nx/documents/connect-to-nx-cloud" /%}
|
|
{% link-card title="Connect to Nx Cloud" type="Feature" url="/ci/intro/connect-to-nx-cloud" /%}
|
|
{% /cards %}
|
|
|
|
### format
|
|
|
|
Overwrite un-formatted files or check for un-formatted files
|
|
|
|
```shell
|
|
nx format
|
|
nx format:check
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx format" type="API Reference" url="/nx-api/nx/documents/format-write" /%}
|
|
{% link-card title="nx format:check" type="API Reference" url="/nx-api/nx/documents/format-check" /%}
|
|
{% /cards %}
|
|
|
|
## Run Tasks
|
|
|
|
These commands run tasks on your code.
|
|
|
|
### run
|
|
|
|
Run a target for a project
|
|
|
|
```shell
|
|
nx run my-app:build
|
|
nx build my-app
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx run" type="API Reference" url="/nx-api/nx/documents/run" /%}
|
|
{% link-card title="Run Tasks" type="Feature" url="/features/run-tasks" /%}
|
|
{% /cards %}
|
|
|
|
### run-many
|
|
|
|
Run target for multiple listed projects
|
|
|
|
```shell
|
|
nx run-many --target=build
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx run-many" type="API Reference" url="/nx-api/nx/documents/run-many" /%}
|
|
{% link-card title="Run Tasks" type="Feature" url="/features/run-tasks" /%}
|
|
{% /cards %}
|
|
|
|
### affected
|
|
|
|
Run target for affected projects
|
|
|
|
```shell
|
|
nx affected --target=build
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx affected" type="API Reference" url="/nx-api/nx/documents/affected" /%}
|
|
{% link-card title="Run Only Tasks Affected by a PR" type="Feature" url="/ci/features/affected" /%}
|
|
{% /cards %}
|
|
|
|
### exec
|
|
|
|
Executes any command as if it was a target on the project
|
|
|
|
```json {% fileName="package.json" %}
|
|
{
|
|
"scripts": {
|
|
"build": "nx exec -- node ./my-custom-build.js"
|
|
}
|
|
}
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx exec" type="API Reference" url="/nx-api/nx/documents/exec" /%}
|
|
{% link-card title="Run Root Level NPM Scripts with Nx" type="Recipe" url="/recipes/running-tasks/root-level-scripts#run-rootlevel-npm-scripts-with-nx" /%}
|
|
{% /cards %}
|
|
|
|
### watch
|
|
|
|
Watch for changes within projects, and execute commands
|
|
|
|
```shell
|
|
nx watch --projects=assets -- nx build assets
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx watch" type="API Reference" url="/nx-api/nx/documents/watch" /%}
|
|
{% link-card title="Workspace Watching" type="Recipe" url="/recipes/running-tasks/workspace-watching" /%}
|
|
{% /cards %}
|
|
|
|
### release
|
|
|
|
Orchestrate versioning and publishing of applications and libraries
|
|
|
|
```shell
|
|
nx release version
|
|
nx release changelog
|
|
nx release publish
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx release" type="API Reference" url="/nx-api/nx/documents/release" /%}
|
|
{% link-card title="Manage Releases" type="Feature" url="/features/manage-releases" /%}
|
|
{% /cards %}
|
|
|
|
### reset
|
|
|
|
Clears cached Nx artifacts and metadata about the workspace and shuts down the Nx Daemon.
|
|
|
|
```shell
|
|
nx reset
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx reset" type="API Reference" url="/nx-api/nx/documents/reset" /%}
|
|
{% /cards %}
|
|
|
|
## Display Information
|
|
|
|
### show
|
|
|
|
Show information about the workspace (e.g., list of projects)
|
|
|
|
```shell
|
|
nx show projects
|
|
nx show project my-app
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx show" type="API Reference" url="/nx-api/nx/documents/show" /%}
|
|
{% link-card title="Explore Projects in Your Workspace" type="Recipe" url="/features/explore-graph#explore-projects-in-your-workspace" /%}
|
|
{% /cards %}
|
|
|
|
### graph
|
|
|
|
Graph dependencies within workspace
|
|
|
|
```shell
|
|
nx graph
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx graph" type="API Reference" url="/nx-api/nx/documents/dep-graph" /%}
|
|
{% link-card title="Explore Your Workspace" type="Recipe" url="/features/explore-graph" /%}
|
|
{% /cards %}
|
|
|
|
### list
|
|
|
|
Lists installed plugins, capabilities of installed plugins and other available plugins.
|
|
|
|
```shell
|
|
nx list
|
|
nx list my-plugin
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx list" type="API Reference" url="/nx-api/nx/documents/list" /%}
|
|
{% /cards %}
|
|
|
|
### report
|
|
|
|
Reports useful version numbers to copy into the Nx issue template
|
|
|
|
```shell
|
|
nx report
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx report" type="API Reference" url="/nx-api/nx/documents/report" /%}
|
|
{% /cards %}
|
|
|
|
### daemon
|
|
|
|
Prints information about the Nx Daemon process or starts a daemon process
|
|
|
|
```shell
|
|
nx daemon
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="nx daemon" type="API Reference" url="/nx-api/nx/documents/daemon" /%}
|
|
{% link-card title="Nx Daemon" type="Concept" url="/concepts/nx-daemon" /%}
|
|
{% /cards %}
|
|
|
|
## Create Commands
|
|
|
|
### create-nx-workspace
|
|
|
|
Create a new Nx workspace
|
|
|
|
```shell
|
|
npx create-nx-workspace
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="create-nx-workspace" type="API Reference" url="/nx-api/nx/documents/create-nx-workspace" /%}
|
|
{% /cards %}
|
|
|
|
### create-nx-plugin
|
|
|
|
Create a new Nx workspace with a preset designed for writing an Nx plugin
|
|
|
|
```shell
|
|
npx create-nx-plugin
|
|
```
|
|
|
|
{% cards %}
|
|
{% link-card title="Extending Nx with Plugins" type="Concept" url="/extending-nx/intro/getting-started" /%}
|
|
{% /cards %}
|