This guide explains how to set up your environment for Angular development using the Angular CLI tool. It includes information about prerequisites, installing the CLI, creating an initial workspace and starter app, and running that app locally to verify your setup.
If you are new to Angular, see Getting Started. Getting Started helps you quickly learn the essentials of Angular, in the context of building a basic online store app. It leverages the StackBlitz online development environment, so you don't need to set up your local environment until you're ready.
Before you begin, make sure your development environment includes
Node.js® and an npm package manager.
Node.js version 10.9.0 or later.
To check your version, run
node -v in a terminal/console window.
Node.js, go to nodejs.org.
Angular, the Angular CLI, and Angular apps depend on features and functionality provided by libraries that are available as npm packages. To download and install npm packages, you must have an npm package manager.
This setup guide uses the npm client command line interface, which is installed with
Node.js by default.
To check that you have the npm client installed, run
npm -v in a terminal/console window.
You use the Angular CLI to create projects, generate application and library code, and perform a variety of ongoing development tasks such as testing, bundling, and deployment.
Install the Angular CLI globally.
To install the CLI using
npm, open a terminal/console window and enter the following command:
npm install -g @angular/cli
You develop apps in the context of an Angular workspace.
To create a new workspace and initial starter app:
Run the CLI command
ng new and provide the name
my-app, as shown here:
ng new my-app
ng new command prompts you for information about features to include in the initial app. Accept the defaults by pressing the Enter or Return key.
The Angular CLI installs the necessary Angular npm packages and other dependencies. This can take a few minutes.
The CLI creates a new workspace and a simple Welcome app, ready to run.
The Angular CLI includes a server, so that you can easily build and serve your app locally.
Go to the workspace folder (
Launch the server by using the CLI command
ng serve, with the
cd my-app ng serve --open
ng serve command launches the server, watches your files, and rebuilds the app as you make changes to those files.
--open (or just
-o) option automatically opens your browser to
Your app greets you with a message:
If you are new to Angular, see the Getting Started tutorial. Getting Started helps you quickly learn the essentials of Angular, in the context of building a basic online store app.
ng new, see Workspace and Project File Structure.
© 2010–2019 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.