Merge branch 'feature/root-method' into develop

README.md

@@ -111,6 +111,16 @@ When the express app receive a `GET /home` request, the index action handler of
 Any express supported method (router.METHOD) can be used.
 
 
+#### Root
+
+You can specify how to route `GET /` with the root method:
+
+```javascript
+router.root({ to: 'welcome#index' })
+router.root('welcome#index') // shortcut for the above
+```
+
+
 #### Named parameters
 
 Named parameters are also supported:

lib/router.js

@@ -119,6 +119,14 @@ Router.prototype._parseControllerActionNotation = function parseControllerAction
 };
 
 
+Router.prototype.root = function root(opts) {
+  if (_.isString(opts)) opts = { to: opts };
+  this.layers.push(this._parseRoute({method: 'get', path: '/', opts }));
+
+  return this;
+};
+
+
 Router.prototype.resources = function(resource, fn) {
   if (_.isArray(resource)) {
     resource.forEach((resource) => {

test/guidanceTest.js

@@ -93,6 +93,38 @@ describe('guidance', function() {
         .end(done)
       ;
     });
+
+
+    it('use root method', function(done) {
+
+      let routes = function(router) {
+        router.root({ to: 'welcome#index'});
+      };
+
+      app.use(guidance.initialize(routes, { controllersDir }));
+
+      request(app)
+        .get('/')
+        .expect(200)
+        .end(done)
+      ;
+    });
+
+
+    it('use root method shorthand', function(done) {
+
+      let routes = function(router) {
+        router.root('welcome#index');
+      };
+
+      app.use(guidance.initialize(routes, { controllersDir }));
+
+      request(app)
+        .get('/')
+        .expect(200)
+        .end(done)
+      ;
+    });
   });
 
   context('resource', function() {

test/utils/controllers/welcome.js

@@ -2,6 +2,9 @@ module.exports = {
   index: function(req, res) {
     res.json({ message: 'index action' });
   },
+  about: function(req, res) {
+    res.json({ message: 'about action' });
+  },
   homepage: function(req, res) {
     res.json({
       helpers: {