generator-gulp-ng

This is a yeoman generator for an angularjs project that follows the Best Practice Recommendations for Angular App Structure.

It takes advantage of the gulp build tool and makes use of bower and npm for dependency management.

---

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

---

FEAUTURES

• follows the recommended best practice project structure for angularjs
• all js files in the app folder are concatenated into build/app.js
• all html files in the app folder except index.html are concatenated and compiled into a js file:build/templates.js and loaded into the angular templateCache
• all 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.html is 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

1. npm install -g generator-gulp-ng

2. mkdir myApp && cd myApp && yo gulp-ng

3. gulp

4. karma start karma-unit.js

5. open browser to http://localhost:9000

6. start hacking

---

Support

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