Added Grunt.js example project

Author: b00gizm

04-express-grunt-watch/.gitignore

@@ -0,0 +1 @@
+public/stylesheets/**

04-express-grunt-watch/Dockerfile

@@ -0,0 +1,20 @@
+FROM dockerfile/nodejs
+
+RUN apt-get update -qq && apt-get install -y build-essential
+RUN apt-get install -y ruby
+RUN gem install sass
+
+RUN mkdir /src
+
+RUN npm install grunt-cli -g
+
+WORKDIR /src
+ADD app/package.json /src/package.json
+RUN npm install
+
+ADD app/Gruntfile.js /src/Gruntfile.js
+
+EXPOSE 3000
+EXPOSE 35729
+
+CMD ["npm", "start"]

04-express-grunt-watch/README.md

@@ -0,0 +1,45 @@
+# Express app with Grunt.js build system
+
+This app contains a [Grunt](http://gruntjs.com/) configuration which will
+
+* Restart the app on **.js**, **.json** or **.hjs** file changes via [grunt-nodemon](https://github.com/ChrisWren/grunt-nodemon)
+* Automatically compile [SASS](http://sass-lang.com/) stylesheets to CSS via [grunt-contrib-watch](https://github.com/gruntjs/grunt-contrib-watch) and [grunt-contrib-sass](https://github.com/gruntjs/grunt-contrib-sass)
+* Manage the concurrent `nodemon` and `watch` tasks via [grunt-concurrent](https://github.com/sindresorhus/grunt-concurrent)
+
+## Prerequisites
+
+Install [Docker](https://www.docker.com/) on your system.
+
+* [Install instructions](https://docs.docker.com/installation/mac/) for Mac OS X
+* [Install instructions](https://docs.docker.com/installation/ubuntulinux/) for Ubuntu Linux
+* [Install instructions](https://docs.docker.com/installation/) for other platforms
+
+Install [Fig](http://fig.sh) on your system.
+
+* Homebrew (OS X): `brew install fig`
+* Python/pip: `sudo pip install -U fig`
+* Other: ``curl -L https://github.com/docker/fig/releases/download/1.0.0/fig-`uname -s`-`uname -m` > /usr/local/bin/fig; chmod +x /usr/local/bin/fig``
+
+## Setup
+
+Run `fig build`. It will
+
+* install [Ruby](https://www.ruby-lang.org) and [SASS](https://rubygems.org/gems/sass)
+* install the [Grunt](http://gruntjs.com) CLI globally
+* install all dependencies from the package.json locally
+* expose port 3000 to the host
+* instruct the container to execute `grunt` on start up.
+
+## Start
+
+Run `fig up` to create and start the container. The app should then be running on your docker daemon on port 3030 (On OS X you can use `boot2docker ip` to find out the IP address).
+
+Go ahead and change any SASS stylesheet inside app/public/sass, and watch it autmatically compile to CSS.
+
+## Notes for boot2docker
+
+It [appears](https://github.com/boot2docker/boot2docker/issues/290) that boot2docker (OS X, Windows) currently does not automatically sync the system clock with the host system after a host resumes from sleep. This becomes a problem due to the way nodemon detects file changes. That might cause it to go bananas, if the clocks on both systems are "too much" out of sync. Until this is fixed, you might use [this workaround](https://github.com/boot2docker/boot2docker/issues/290#issuecomment-62384209) or simply do a manual sync via
+
+```bash
+/usr/local/bin/boot2docker ssh sudo ntpclient -s -h pool.ntp.org
+```

04-express-grunt-watch/app/Gruntfile.js

@@ -0,0 +1,66 @@
+module.exports = function(grunt) {
+
+  // Project configuration.
+  grunt.initConfig({
+
+    pkg: grunt.file.readJSON('package.json'),
+
+    concurrent: {
+      dev: {
+        tasks   : ['nodemon', 'watch'],
+        options : {
+          logConcurrentOutput: true
+        }
+      }
+    },
+
+    nodemon: {
+      dev: {
+        script  : 'app/bin/www',
+        options : {
+          args        : ['dev'],
+          nodeArgs    : ['--debug'],
+          ext         : 'js hjs json',
+          ignore      : ['node_modules/**'],
+          legacyWatch : true
+        }
+      }
+    },
+
+    sass: {
+      dist: {
+        files: [
+          {
+            expand : true,
+            cwd    : 'app/public/scss',
+            src    : 'style.scss',
+            dest   : 'app/public/stylesheets',
+            ext    : '.css'
+          }
+        ]
+      }
+    },
+
+    watch: {
+      sass: {
+        files : ['app/public/scss/**/*.scss'],
+        tasks : ['sass'],
+        options: {
+          livereload: true
+        }
+      }
+    }
+
+  });
+
+  // Load the plugin that provides the "uglify" task.
+  grunt.loadNpmTasks('grunt-concurrent');
+  grunt.loadNpmTasks('grunt-contrib-sass');
+  grunt.loadNpmTasks('grunt-contrib-watch');
+  grunt.loadNpmTasks('grunt-nodemon');
+  //grunt.loadNpmTasks('grunt-simple-watch');
+
+  // Default task(s).
+  grunt.registerTask('default', ['sass', 'concurrent']);
+
+};

04-express-grunt-watch/app/app.js

@@ -0,0 +1,60 @@
+var express = require('express');
+var path = require('path');
+var favicon = require('serve-favicon');
+var logger = require('morgan');
+var cookieParser = require('cookie-parser');
+var bodyParser = require('body-parser');
+
+var routes = require('./routes/index');
+var users = require('./routes/users');
+
+var app = express();
+
+// view engine setup
+app.set('views', path.join(__dirname, 'views'));
+app.set('view engine', 'hjs');
+
+// uncomment after placing your favicon in /public
+//app.use(favicon(__dirname + '/public/favicon.ico'));
+app.use(logger('dev'));
+app.use(bodyParser.json());
+app.use(bodyParser.urlencoded({ extended: false }));
+app.use(cookieParser());
+app.use(express.static(path.join(__dirname, 'public')));
+
+app.use('/', routes);
+app.use('/users', users);
+
+// catch 404 and forward to error handler
+app.use(function(req, res, next) {
+    var err = new Error('Not Found');
+    err.status = 404;
+    next(err);
+});
+
+// error handlers
+
+// development error handler
+// will print stacktrace
+if (app.get('env') === 'development') {
+    app.use(function(err, req, res, next) {
+        res.status(err.status || 500);
+        res.render('error', {
+            message: err.message,
+            error: err
+        });
+    });
+}
+
+// production error handler
+// no stacktraces leaked to user
+app.use(function(err, req, res, next) {
+    res.status(err.status || 500);
+    res.render('error', {
+        message: err.message,
+        error: {}
+    });
+});
+
+
+module.exports = app;

04-express-grunt-watch/app/bin/www

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+var debug = require('debug')('app');
+var app = require('../app');
+
+app.set('port', process.env.PORT || 3000);
+
+var server = app.listen(app.get('port'), function() {
+  debug('Express server listening on port ' + server.address().port);
+});

04-express-grunt-watch/app/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "app",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "start": "grunt"
+  },
+  "dependencies": {
+    "express": "~4.9.0",
+    "body-parser": "~1.8.1",
+    "cookie-parser": "~1.3.3",
+    "morgan": "~1.3.0",
+    "serve-favicon": "~2.1.3",
+    "debug": "~2.0.0",
+    "hjs": "~0.0.6"
+  },
+  "devDependencies": {
+    "grunt": "~0.4.5",
+    "grunt-concurrent": "~1.0.0",
+    "grunt-contrib-sass": "~0.8.1",
+    "grunt-contrib-watch": "~0.6.1",
+    "grunt-nodemon": "~0.3.0",
+    "grunt-simple-watch": "~0.1.2"
+  }
+}

04-express-grunt-watch/app/public/images/.gitkeep

@@ -0,0 +1,4 @@
+$font-family: "Lucida Grande", Helvetica, Arial, sans-serif;
+$font-size:   14;
+
+$padding:     50px;