Angular Starter Kit

Join the chat at NPM version Build Status devDependency Status npm

A better way to start your new Angular app

Angular Logo



We assume you've already installed NodeJS, Gulp and Bower on your machine, if not, please follow the installation documentation from the official websites.


The easiest way to start your Angular project using Angular Starter Kit is Downloading the latest release of this project or simply cloning this repository with:

git clone


Once done with the previous step, open your terminal to your angular-starter-kit folder, then install all the dependencies with:

npm install

This will create both a node_modules and bower_components folder inside your local directory

Run the Application

There is already a preconfigured web server for this application. The simplest way to start this server is:

npm start

Now browse to the app url available at http://localhost:8000 to see your application running.

This task will also watch for any file change to your project's files and update the browser with the new changes using BrowserSync and Gulp.

Build a production version

npm run build

This will perform the following tasks:

Serve the distribution folder

npm run serve:dist

This will compile your project in distribution mode and will trigger a web server to listen to your generated dist folder.

Open a browser and navigating to http://localhost:8000 to see the rendered application.

Unit tests

npm test

This will run all the unit tests present in your project folder using Karma.

The task will remain idle in your terminal waiting for file changes to run the tests again. This task is really useful during the development mode in order to avoid running manually your tests every time.

However, if you want just to run the test once and build a report displaying the unit test coverage, use the following task:

npm run test-single-run

Either way, all the reports will be stored inside a generated test_out folder and a coverage for the unit test coverage using Istanbul

End to end testing

The Angular Starter Kit app comes with end-to-end tests written in Jasmine. These tests are run with the Protractor End-to-End test runner.

Your web server needs to be serving up the application, so that Protractor can interact with it.

In order to start running your end-to-end tests, first start your web server with:

npm start

Now you can run the end-to-end tests, from another terminal instance, using the supplied npm script:

npm run protractor


We really appreciate your collaborations and feedbacks!

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D


Changelog available here