ng new
ng new [name] [--[argument]=[value]]
ng n
Creates a new angular application.
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 thee2e/
subfolder.The new app's configuration appears in the
projects
section of theangular.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 |
--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 |