Tools - Do you know what Angular Tools to install for an Angular project?
This rule explains what to install in order to get started creating an Angular project.
The best practice for creating an Angular project and components is to use the Angular CLI (command-line interface).
The Angular CLI is also used in the latest .NET Angular SPA template. Read Do you know that the ASP.NET Core SPA Template for Angular uses the Angular CLI?
The libraries that are required to get started are:
- Node.js (https://nodejs.org/) and NPM (https://www.npmjs.com/)
- Git (https://git-scm.com/), and
- Angular CLI (https://angular.io/cli)
Check that you have a version of Node.js installed that is compatible with the latest version of Angular. The latest Long Term Support (LTS) version of Node.js is a safe bet.
To check you have the correct version of Node.js run the following from a terminal/command window.
If you have older versions of Node.js or don't have it installed, please install the latest LTS version from here: https://nodejs.org/en
As of Angular 9, you need to be on Node 11+.
Check that you are running NPM 6+ by running the following from a terminal/console window:
If you have a version of NPM < 6, install the latest version running the following command from a terminal/console window. If you don’t have NPM installed, use the Node.js installer to install NPM.
npm install -g npm@latest
Install git https://git-scm.com
Check you have git by running the following from a terminal/command window:
Check you have the latest version of the Angular CLI installed globally by running the following command in the terminal/command window. Check the result against the latest version shown on GitHub here: https://github.com/angular/angular-cli.
If you don’t have Angular CLI installed, then run the command below in a terminal/command window to install it.
npm install -g @angular/cli
If you are not running the latest version, we recommend you run the below commands to update the global version of the Angular CLI.
npm install -g @angular/cli@latest
Upgrading the global Angular CLI version will not affect the version of the Angular CLI being used by existing local project. Multiple versions of the Angular CLI can run on the same machine, and the project specific version of Angular CLI will continue to be used by the project until you manually upgrade the project’s local version.
Instructions for upgrading the Angular CLI of an existing project can be found here: https://update.angular.io
If you get node gyp errors, follow instructions here: https://github.com/nodejs/node-gyp
If you get permission errors, follow instructions here: https://docs.npmjs.com/getting-started/fixing-npm-permissions