CLI

new

Command
ng new
ng n

Creates and initializes a new Angular application 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 application (with the same name as the workspace) are placed in the src/ subfolder.

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

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

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

Arguments

name

The name of the new workspace and initial project.

Value Typestring

Options

collection
Aliasc

A collection of schematics to use in generating the initial application.

Value Typestring
commit

Initial git repository commit information.

Value TypebooleanDefaulttrue
create-application

Create a new initial application project in the 'src' folder of the new workspace. When false, creates an empty workspace with no initial application. You can then use the generate application command so that all applications are created in the projects folder.

Value TypebooleanDefaulttrue
defaults

Disable interactive input prompts for options with a default.

Value TypebooleanDefaultfalse
directory

The directory name to create the workspace in.

Value Typestring
dry-run
Aliasd

Run through and reports activity without writing out results.

Value TypebooleanDefaultfalse
force

Force overwriting of existing files.

Value TypebooleanDefaultfalse
help

Shows a help message for this command in the console.

Value Typeboolean
inline-style
Aliass

Include styles inline in the component TS file. By default, an external styles file is created and referenced in the component TypeScript file.

Value Typeboolean
inline-template
Aliast

Include template inline in the component TS file. By default, an external template file is created and referenced in the component TypeScript file.

Value Typeboolean
interactive

Enable interactive input prompts.

Value TypebooleanDefaulttrue
minimal

Create a workspace without any testing frameworks. (Use for learning purposes only.)

Value TypebooleanDefaultfalse
new-project-root

The path where new projects will be created, relative to the new workspace root.

Value TypestringDefaultprojects
package-manager

The package manager used to install dependencies.

Value Typestring
prefix
Aliasp

The prefix to apply to generated selectors for the initial project.

Value TypestringDefaultapp
routing

Enable routing in the initial project.

Value Typeboolean
skip-git
Aliasg

Do not initialize a git repository.

Value TypebooleanDefaultfalse
skip-install

Do not install dependency packages.

Value TypebooleanDefaultfalse
skip-tests
AliasS

Do not generate "spec.ts" test files for the new project.

Value TypebooleanDefaultfalse
ssr

Creates an application with Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering) enabled.

Value Typeboolean
standalone

Creates an application based upon the standalone API, without NgModules.

Value TypebooleanDefaulttrue
strict

Creates a workspace with stricter type checking and stricter bundle budgets settings. This setting helps improve maintainability and catch bugs ahead of time. For more information, see https://angular.dev/tools/cli/template-typecheck#strict-mode

Value TypebooleanDefaulttrue
style

The file extension or preprocessor to use for style files.

Value Typestring
view-encapsulation

The view encapsulation strategy to use in the initial project.

Value Typestring
Jump to details