Setup for Development 5.3
Setting up a new Angular project is straightforward using common Dart tools. This page leads you through getting and running the starter app that’s featured in this guide and tutorial.
Get prerequisites
For information on how to get these prerequisite tools, see the Dart site:
- Dart SDK 2.5.0 or a compatible version
- Your favorite IDE, or WebStorm (recommended).
Create a starter project
The examples in this guide and tutorial are based on the angular-examples/quickstart GitHub project. You can get the project’s files by the following methods:
- Downloading them.
- Cloning the repo.
- Using WebStorm’s Git support.
Use WebStorm’s Git support
- Launch WebStorm.
- If you haven’t already done so, configure Dart support in WebStorm.
- From the welcome screen, choose Check out from Version Control > Git.
Alternatively, from the menu, choose VCS > Git > Clone…
A Clone Repository dialog appears. - Fill out the following fields:
-
Git Repository URL:
https://github.com/angular-examples/quickstart
- Parent Directory: (wherever you like to keep your practice code)
-
Directory Name:
angular_tour_of_heroes
(or any other valid package name)
-
Git Repository URL:
- Click Clone.
Get dependencies
In WebStorm:
- Open the new project.
- In the project view, double-click
pubspec.yaml
. - At the upper right of the editor view of
pubspec.yaml
:- Click Enable Dart support.
- Click Get dependencies.
WebStorm takes several seconds to analyze the sources and do other housekeeping. This only happens once. After that, you’ll be able to use WebStorm for the usual IDE tasks, including running the app.
If you aren’t using WebStorm, you can use the following command in a terminal window:
$ pub get
Customize the project
Using WebStorm, or your favorite editor:
-
Open
web/index.html
, and replace the text of the<title>
element with a title suitable for your app. For example:<title>Angular Tour of Heroes</title>
. -
Open
pubspec.yaml
, and update the description to suit your project. For example:description: Tour of Heroes
. -
Optional. If you’d like to change your project’s name, then do a project-wide search-and-replace of the current value of the pubspec
name
entry (angular_app
) with a name suitable for your app — usually it will be the same as the directory name you chose earlier.This project-global rename will touch:
pubspec.yaml
,web/main.dart
andtest/app_test.dart
.
Run the app
In WebStorm:
- In the project view, right-click
web/index.html
. - Choose Run ‘index.html’.
You should see the following app in a browser window:
To run the app from the command line, use webdev to build and serve the app:
$ webdev serve
Then, to view your app, use the Chrome browser to visit localhost:8080. (Details about Dart’s browser support are in the FAQ.)
Reload the app
Whenever you change the app, reload the browser window.
As you save updates to the code, the pub
tool detects changes and
serves the new app.
Next step
If you’re new to Angular, we recommend staying on the learning path. If you’d like to know more about the app you just created, see The Starter App.