ng new • Angular
name
The name for the new workspace and the initial project. This name will be used for the root directory and various identifiers throughout the project.
Value Typestring
ai-config
Specifies which AI tools to generate configuration files for. These file are used to improve the outputs of AI tools by following the best practices.
Value TypearrayAllowed Valuesagents, claude, copilot, cursor, gemini, jetbrains, none, windsurf
A collection of schematics to use in generating the initial application.
Value Typestring
commit
Configure the initial Git commit for the new repository.
Value TypebooleanDefaulttrue
create-application
Create a new initial application project in the new workspace. When false, creates an empty workspace with no initial application. You can then use the ng generate application command to create applications in the projects directory.
Value TypebooleanDefaulttrue
defaults
Disable interactive input prompts for options with a default.
Value TypebooleanDefaultfalse
directory
The directory where the new workspace and project should be created. If not specified, the workspace will be created in the current directory.
Value Typestring
Run through and reports activity without writing out results.
Value TypebooleanDefaultfalse
file-name-style-guide
The file naming convention to use for generated files. The '2025' style guide (default) uses a concise format (e.g., app.ts for the root component), while the '2016' style guide includes the type in the file name (e.g., app.component.ts). For more information, see the Angular Style Guide (https://angular.dev/style-guide).
Value TypestringAllowed Values2016, 2025Default2025
force
Force overwriting of existing files.
Value TypebooleanDefaultfalse
help
Shows a help message for this command in the console.
Value Typeboolean
Include the styles for the initial application's root component directly within the app.ts file. By default, a separate stylesheet file (e.g., app.css) is created.
Value Typeboolean
Include the HTML template for the initial application's root component directly within the app.ts file. By default, a separate template file (e.g., app.html) is created.
Value Typeboolean
interactive
Enable interactive input prompts.
Value TypebooleanDefaulttrue
minimal
Generate a minimal Angular workspace without any testing frameworks. This is intended for learning purposes and simple experimentation, not for production applications.
Value TypebooleanDefaultfalse
new-project-root
The path where new projects will be created within the workspace, relative to the workspace root. By default, new projects are created in the projects directory.
Value TypestringDefaultprojects
package-manager
The package manager used to install dependencies.
Value TypestringAllowed Valuesbun, npm, pnpm, yarn
The prefix to apply to generated selectors for the initial project. For example, if the prefix is my-app and you generate a component named my-component, the selector will be my-app-my-component.
Value TypestringDefaultapp
routing
Enable routing in the initial application project. This sets up the necessary files and modules for managing navigation between different views in your application.
Value Typeboolean
Do not initialize a Git repository in the new workspace. By default, a Git repository is initialized to help you track changes to your project.
Value TypebooleanDefaultfalse
skip-install
Skip the automatic installation of packages. You will need to manually install the dependencies later.
Value TypebooleanDefaultfalse
Skip the generation of unit test files spec.ts.
Value TypebooleanDefaultfalse
ssr
Configure the initial application for Server-Side Rendering (SSR) and Static Site Generation (SSG/Prerendering).
Value Typeboolean
standalone
Creates an application based upon the standalone API, without NgModules.
Value TypebooleanDefaulttrue
Value TypebooleanDefaulttrue
style
The type of stylesheet files to be created for components in the initial project.
Value TypestringAllowed Valuescss, less, sass, scss, tailwind
test-runner
The unit testing runner to use.
Value TypestringAllowed Valueskarma, vitestDefaultvitest
view-encapsulation
Sets the view encapsulation mode for components in the initial project. This determines how component styles are scoped and applied. Options include: Emulated (default, styles are scoped to the component), None (styles are global), and ShadowDom (styles are encapsulated using Shadow DOM).
Value TypestringAllowed ValuesEmulated, None, ShadowDom
zoneless
Create an initial application that does not utilize zone.js.
Value Typeboolean