generator-gulp-ng-fast

This is a yeoman generator for an AngularJS project that follows the Best Practice Recommendations for Angular App Structure. It's based on generator-gulp-ng by Jessie Evangelista with additions to support Coffeescript, Less and Jade files for _fast_er development.

Uses Gulp (now I'm convinced by JS build tools!), Bower and NPM.

GENERATED DIRECTORY STRUCTURE

app/
  components/
    app_service.js
    app_service_test.js
  main/
    main.html
    main_controller.js
    main_controller_test.js
  app.css
  app.js
  app_controller.js
  app_controller_test.js
  index.html
bower_components/    
node_modules/
.bowerrc
.gitignore
README.md
bower.json
gulpgile.js
karma-unit.js
package.json

FEATURES

• Follows the recommended best practice project structure for AngularJS
• All Coffee/JS files in the app folder are compiled and concatenated into build/app.js
• All Jade/HTML files in the app folder except index.html are concatenated and compiled into a JS file: build/templates.js and loaded into AngularJS templateCache
• All Less/CSS files in the app folder are concatenated into build/app.css
• All JS files in the bower_components folder are concatenated into build/lib.js
• All CSS files in the bower_components folder are concatenated into build/lib.css
• index.jade/index.html is compiled/copied to build/index.html
• A static server is run at port 9000 with livereload support
• When any HTML, JS or CSS file in the build folder changes, they are autoreloaded on the browser
• Karma test runner will automatically run unit tests when relevant files change

Prerequisites

• node.js http://nodejs.org/
• npm http://www.npmjs.org/
• bower http://bower.io/
• gulp.js http://gulpjs.com/
• karma-cli http://karma-runner.github.io/

Usage

npm install -g generator-gulp-ng-fast
mkdir my-app && cd my-app && yo gulp-ng-fast
npm install
npm install -g karma-cli
gulp
karma start karma-unit.js

Then you can open your browser on http://localhost:9000 and start hacking!

Support

For questions and issues: https://github.com/rchampourlier/generator-gulp-ng-fast/issues