lynndylanhurley / gulp-ng-base

Gulp, angular, jade, stylus, bootstrap project base.

defsynth

About

This app uses the following:

Languages

• jade templates
• stylus stylesheets
• coffeescript

Libraries

• bootstrap
• nib
• jquery
• angularjs
• angular-ui router
• angular-strap
• lodash
• modernizr

Testing

• karma
• protractor
• mocha
• chai
• sinon

---

Requirements

• nodejs
• cairo

Installation

1. brew install cairo - for sprites
2. export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/X11/lib/pkgconfig - still for sprites
3. npm install - install all server-side deps
4. bower install - install all client-side deps

---

Development

Start Dev Server

gulp dev - broadcast dev server to localhost:9000. use livereload for automatic refresh.

---

Testing

Unit Tests

Unit tests use karma + mocha.

karma start - runs all tests in test/unit/**/*.coffee

E2E Tests

E2E Tests use protractor + mocha.

gulp test:e2e - runs all tests in test/e2e/**/*.coffee

---

Deployment

This assumes the following, where ENV_NAME is the name of the target NODE_ENV (production, staging, etc.)

1. An heroku app exists, and its git remote is named ENV_NAME
2. The heroku app has its NODE_ENV set to ENV_NAME (using heroku config:set)
3. there is an s3 bucket config defined in config/ENV_NAME.yml. see config/production.yml.example for an example configuration.

Push to heroku production env

NODE_ENV=production gulp deploy

Push to heroku staging env

NODE_ENV=staging gulp deploy