Oh Hell Teste that this is only a getting started guide, for more detailed information about the build system, the available tasks, the configuration of the build or anything else, please refer to the documentation on the GitHub project.

What and Why

angular-kickstart is an opinionated kickstart for single page application development with AngularJS. It makes your development and testing easy, keeps the structure of the project consistent and allows you to create a fully optimized production release withe ease. After having developed a lot of AngularJS projects I decided to collect here what I've learnt.

Getting started

Install node.js. Then sass, gulp and bower if you haven't yet.

    
    $ gem install sass
    $ npm -g install gulp bower
    

After that, install angular-kickstart - download the latest release (or clone the master branch if want to run the development version). Unzip the project and cd into it, then install bower and npm dependencies, and run the application in development mode.

    
    $ npm install
    $ bower install
    $ gulp serve
    

You are now ready to go, your applcation is available at http://127.0.0.1:3000.

You are now ready to start coding, every file you add, edit or delete into the /client folder, will be handled by the build system and the browser will reload.

When you are ready to build a production release there is a task for that.

    
    $ gulp serve:dist
    

This task will lint your code, optimize css js and images files, run unit tests. After the task has successfully finished, you can find an optimized version of your project in the /build/dist folder.

Other tasks are available:

    
    #for developing running unit test on every file change.
    $ gulp serve:tdd

    #for running e2e test. (you application should be running on http://127.0.0.1:3000)
    $ gulp test:e2e

    #for running unit tests one time then exit.
    $ gulp test:unit
    

Full documentation on GitHub