CLI command reference

nest new

Creates a new (standard mode) Nest project.

$ nest new <name> [options]
$ nest n <name> [options]

Description

Creates and initializes a new Nest project. Prompts for package manager.

• Creates a folder with the given <name>
• Populates the folder with configuration files
• Creates sub-folders for source code (/src) and end-to-end tests (/test)
• Populates the sub-folders with default files for app components and tests

Arguments

Argument	Description
<name>	The name of the new project

Options

Option	Description
--dry-run	Reports changes that would be made, but does not change the filesystem. Alias: -d
--skip-git	Skip git repository initialization. Alias: -g
--skip-install	Skip package installation. Alias: -s
--package-manager [package-manager]	Specify package manager. Use npm or yarn. Package manager must be installed globally. Alias: -p
--language [language]	Specify programming language (TS or JS). Alias: -l
--collection [collectionName]	Specify schematics collection. Use package name of installed npm package containing schematic. Alias: -c

nest generate

Generates and/or modifies files based on a schematic

$ nest generate <schematic> <name> [options]
$ nest g <schematic> <name> [options]

Arguments

Argument	Description
<schematic>	The schematic or collection:schematic to generate. See the table below for the available schematics.
<name>	The name of the generated component.

Schematics

Name	Alias	Description
app		Generate a new application within a monorepo (converting to monorepo if it's a standard structure).
library	lib	Generate a new library within a monorepo (converting to monorepo if it's a standard structure).
class	cl	Generate a new class.
controller	co	Generate a controller declaration.
decorator	d	Generate a custom decorator.
filter	f	Generate a filter declaration.
gateway	ga	Generate a gateway declaration.
guard	gu	Generate a guard declaration.
interface		Generate an interface.
interceptor	in	Generate an interceptor declaration.
middleware	mi	Generate a middleware declaration.
module	mo	Generate a module declaration.
pipe	pi	Generate a pipe declaration.
provider	pr	Generate a provider declaration.
resolver	r	Generate a resolver declaration.
resource	res	Generate a new CRUD resource. See the CRUD (resource) generator for more details.
service	s	Generate a service declaration.

Options

Option	Description
--dry-run	Reports changes that would be made, but does not change the filesystem. Alias: -d
--project [project]	Project that element should be added to. Alias: -p
--flat	Do not generate a folder for the element.
--collection [collectionName]	Specify schematics collection. Use package name of installed npm package containing schematic. Alias: -c
--spec	Enforce spec files generation (default)
--no-spec	Disable spec files generation

nest build

Compiles an application or workspace into an output folder.

$ nest build <name> [options]

Arguments

Argument	Description
<name>	The name of the project to build.

Options

Option	Description
--path [path]	Path to tsconfig file. Alias -p
--config [path]	Path to nest-cli configuration file. Alias -c
--watch	Run in watch mode (live-reload) Alias -w
--webpack	Use webpack for compilation.
--webpackPath	Path to webpack configuration.
--tsc	Force use tsc for compilation.

nest start

Compiles and runs an application (or default project in a workspace).

$ nest start <name> [options]

Arguments

Argument	Description
<name>	The name of the project to run.

Options

Option	Description
--path [path]	Path to tsconfig file. Alias -p
--config [path]	Path to nest-cli configuration file. Alias -c
--watch	Run in watch mode (live-reload) Alias -w
--preserveWatchOutput	Keep outdated console output in watch mode instead of clearing the screen. (tsc watch mode only)
--watchAssets	Run in watch mode (live-reload), watching non-TS files (assets). See [Assets]((/cli/workspaces(#assets) for more details.
--debug [hostport]	Run in debug mode (with --inspect flag) Alias -d
--webpack	Use webpack for compilation.
--webpackPath	Path to webpack configuration.
--tsc	Force use tsc for compilation.
--exec [binary]	Binary to run (default: node). Alias -e

nest add

Imports a library that has been packaged as a nest library, running its install schematic.

$ nest add <name> [options]

Arguments

Argument	Description
<name>	The name of the library to import.

nest update

Updates @nestjs dependencies in the package.json "dependencies" list to their @latest version.

Options

Option	Description
--force	Do upgrade instead of update Alias -f
--tag	Update to tagged version (use @latest, @<tag>, etc) Alias -t

nest info

Displays information about installed nest packages and other helpful system info. For example:

 _   _             _      ___  _____  _____  _     _____
| \ | |           | |    |_  |/  ___|/  __ \| |   |_   _|
|  \| |  ___  ___ | |_     | |\ `--. | /  \/| |     | |
| . ` | / _ \/ __|| __|    | | `--. \| |    | |     | |
| |\  ||  __/\__ \| |_ /\__/ //\__/ /| \__/\| |_____| |_
\_| \_/ \___||___/ \__|\____/ \____/  \____/\_____/\___/

[System Information]
OS Version : macOS High Sierra
NodeJS Version : v8.9.0
YARN Version : 1.5.1
[Nest Information]
microservices version : 6.0.0
websockets version : 6.0.0
testing version : 6.0.0
common version : 6.0.0
core version : 6.0.0