nx/docs/generated/cli/add.md

69 lines
1.4 KiB
Markdown

---
title: 'add - CLI command'
description: 'Install a plugin and initialize it.'
---
# add
Install a plugin and initialize it.
## Usage
```shell
nx add <packageSpecifier>
```
Install `nx` globally to invoke the command directly using `nx`, or use `npx nx`, `yarn nx`, or `pnpm nx`.
### Examples
Install the `@nx/react` package matching the installed version of the `nx` package and run its `@nx/react:init` generator:
```shell
nx add @nx/react
```
Install the latest version of the `non-core-nx-plugin` package and run its `non-core-nx-plugin:init` generator if available:
```shell
nx add non-core-nx-plugin
```
Install version `17.0.0` of the `@nx/react` package and run its `@nx/react:init` generator:
```shell
nx add @nx/react@17.0.0
```
## Options
### help
Type: `boolean`
Show help
### packageSpecifier
Type: `string`
The package name and optional version (e.g. `@nx/react` or `@nx/react@latest`) to install and initialize. If the version is not specified it will install the same version as the `nx` package for Nx core plugins or the latest version for other packages
### updatePackageScripts
Type: `boolean`
Update `package.json` scripts with inferred targets. Defaults to `true` when `NX_PCV3=true` and the package is a core Nx plugin
### verbose
Type: `boolean`
Prints additional information about the commands (e.g., stack traces)
### version
Type: `boolean`
Show version number