ng-new

Create a new Angular workspace

$ ng new [my-app]

$ ng new [my-app] --defaults

$ ng new [my-app] --routing

$ ng new [my-app] --style [scss|sass|less|css]

$ ng new [my-app] --skip-git

$ ng new [my-app] --skip-install

$ ng new [my-app] --strict

$ ng new [my-app] --dry-run

ng new [name] [options]

ng new creates a new Angular workspace and generates an initial application. It scaffolds the complete project structure including configuration files, source directories, and optionally installs npm dependencies.
The command sets up TypeScript configuration, Angular-specific settings in angular.json, and testing infrastructure with Karma and Jasmine. The generated workspace follows Angular best practices and conventions.
When run without the --defaults flag, the CLI prompts for routing preferences and stylesheet format. The --strict option enables additional TypeScript compiler checks, stricter bundle budgets, and lint rules for improved code quality.

NAME

Name for the new workspace and initial project.

Generate a routing module for the initial project.

File extension for style files (css, scss, sass, less).

Do not initialize a git repository.

Do not install dependency packages.

Do not generate spec files for the initial project.

Enable stricter type checking and bundle budgets.

Disable interactive prompts and use default values.

Run through without making changes (preview mode).

Prefix for generated selectors (default: app).

Package manager to use (npm, yarn, pnpm, cnpm).

Directory to create the workspace in.

Include styles inline in the component TS file.

Include template inline in the component TS file.

View encapsulation strategy (Emulated, None, ShadowDom).

Configure the application for Server-Side Rendering.

Display help information.

Requires Node.js and Angular CLI installed globally (npm install -g @angular/cli). The workspace name must be a valid npm package name (lowercase, no spaces). Creating large workspaces with full dependency installation can take several minutes depending on network speed.

The ng new command has been part of Angular CLI since its initial release in 2016. It evolved alongside Angular, adding options for routing in Angular 4, strict mode in Angular 10, and SSR scaffolding in Angular 17. The command generates standalone components by default since Angular 17.

ng(1), ng-generate(1), ng-serve(1), ng-build(1)