ng new

ng new [name] [--[argument]=[value]]
ng n

Creates a new angular application.

Links & Tutorials

Creates and initializes a new Angular app that is the default project for a new workspace.

Provides interactive prompts for optional configuration, such as adding routing support. All prompts can safely be allowed to default.

  • The new workspace folder is given the specified project name, and contains configuration files at the top level.

  • By default, the files for a new initial app (with the same name as the workspace) are placed in the src/ subfolder. Corresponding end-to-end tests are placed in the e2e/ subfolder.

  • The new app's configuration appears in the projects section of the angular.json workspace configuration file, under its project name.

  • Subsequent apps that you generate in the workspace reside in the projects/ subfolder.

If you plan to have multiple apps in the workspace, you can create an empty workspace by setting the --createApplication option to false. You can then use ng generate application to create an initial app. This allows a workspace name different from the initial app name, and ensures that all apps reside in the /projects subfolder, matching the structure of the configuration file.

Options

--collection#

Schematics collection to use.

Type string
Default @schematics/angular
Aliases c

--commit#

Initial repository commit information.

Type boolean
Default true

--createApplication#

Flag to toggle creation of an application in the new workspace.

Type boolean
Default true
Links & Tutorials

--defaults#

When true, disables interactive input prompts for options with a default.

Type boolean
Default false

--directory#

The directory name to create the workspace in.

Type string

--dryRun#

Run through without making any changes.

Type boolean
Default false
Aliases d

--force#

Forces overwriting of files.

Type boolean
Default false
Aliases f

--help#

Shows a help message for this command in the console.

Values true|false|json|JSON
Default false

--inlineStyle#

Specifies if the style will be in the ts file.

Type boolean
Default false
Aliases s

--inlineTemplate#

Specifies if the template will be in the ts file.

Type boolean
Default false
Aliases t

--interactive#

When false, disables interactive input prompts.

Type boolean
Default false

--minimal#

Create a barebones project without any testing frameworks.

Type boolean
Default false

--newProjectRoot#

The path where new projects will be created.

Type string
Default projects

--packageManager#

The package manager used to install dependencies.

Type string
Values npm|yarn|pnpm|cnpm

--prefix#

The prefix to apply to generated selectors.

Type string
Default app
Aliases p

--routing#

When true, generates a routing module for the initial project.

Type boolean
Default false

--skipGit#

Skip initializing a git repository.

Type boolean
Default false
Aliases g

--skipPackageJson#

Do not add dependencies to package.json.

Aliases skip-package-json

--skipInstall#

Skip installing dependency packages.

Type boolean
Default false

--skipTests#

Skip creating spec files.

Type boolean
Default false
Aliases S

--strict#

Creates a workspace with stricter TypeScript compiler options.

Type boolean
Default false

--style#

The file extension to be used for style files.

Type string
Values css, scss, less, sass, styl
Default css

--verbose#

Adds more details to output logging.

Type boolean
Default false
Aliases v

--viewEncapsulation#

Specifies the view encapsulation strategy.

Values Emulated|Native|None|ShadowDom
Aliases view-encapsulation