Build your first Angular app

This tutorial consists of lessons that introduce the Angular concepts you need to know to start coding in Angular.

You can do as many or as few as you would like and you can do them in any order.

HELPFUL: Prefer video? We also have a full YouTube course for this tutorial!

Before you start

For the best experience with this tutorial, review these requirements to make sure you have what you need to be successful.

Your experience

The lessons in this tutorial assume that you have experience with the following:

  1. Created an HTML web page by editing the HTML directly.
  2. Programmed web site content in JavaScript.
  3. Read Cascading Style Sheet (CSS) content and understand how selectors are used.
  4. Used command-line instructions to perform tasks on your computer.

Your equipment

These lessons can be completed using a local installation of the Angular tools or in our embedded editor. Local Angular development can be completed on Windows, MacOS or Linux based systems.

Note: Look for alerts like this one, which call out steps that may only be for your local editor.

Conceptual preview of your first Angular app

The lessons in this tutorial create an Angular app that lists houses for rent and shows the details of individual houses. This app uses features that are common to many Angular apps.

Output of homes landing page

Local development environment

Note: This step is only for your local environment!

Perform these steps in a command-line tool on the computer you want to use for this tutorial.

  1. Identify the version of node.js that Angular requires

    Angular requires an active LTS or maintenance LTS version of Node. Let's confirm your version of node.js. For information about specific version requirements, see the engines property in the package.json file.

    From a Terminal window:

    1. Run the following command: node --version
    2. Confirm that the version number displayed meets the requirements.
  2. Install the correct version of node.js for Angular

    If you do not have a version of node.js installed, please follow the directions for installation on nodejs.org

  3. Install the latest version of Angular

    With node.js and npm installed, the next step is to install the Angular CLI which provides tooling for effective Angular development.

    From a Terminal window run the following command: npm install -g @angular/cli.

  4. Install integrated development environment (IDE)

    You are free to use any tool you prefer to build apps with Angular. We recommend the following:

    1. Visual Studio Code
    2. As an optional, but recommended step you can further improve your developer experience by installing the Angular Language Service
    3. WebStorm

For more information about the topics covered in this lesson, visit: