MVC project structure on top of express.

npm install express-struct
16 downloads in the last week
38 downloads in the last month

build status

MVC project structure on top of express.

It defines a strict directories structure for you and maps automatically the routes.


  • dirs structure
  • auto routing using "modules/controllers/action" pattern
  • res.render knows its default template name
  • CRUD


  • mvc
    • {mymodule}
      • controllers
        • {mycontroller}.js
      • views
        • {mycontroller}
          • {myview.html}
        • layout.html
      • models
      • helpers
      • tests
    • {mymodule1}


var struct = require('express-struct'),
    express = require('express');

var app = express();

struct.setup(app, options);


// /mvc/mymodule/controllers/mycontroller.js
exports.myaction = function(req, res, next) {
    // will render /mvc/mymodule/views/mycontroller/myaction.html



    // Root directory where mvc is located.
    root: process.cwd(),
    route: '/:module?/:controller?/:action?(/*)?',

    // Convert paths after action into query
    // /app/user/create/name/kof -> query = {name: 'kof'}
    paramQuery: true,

    // Module name used if nothing else passed.
    defaultModule: 'index',

    // Enabled modules list.
    moduleNames: null,

    // Error handler.
    error: function() {}


Default module is defined in options. Default controller is module name. Default action is controller name.

'/mymodule' -> '/mvc/mymodule/controllers/mymodule:mymodule'

'/mymodule/mycontroller' -> '/mvc/mymodule/controllers/mycontroller:mycontroller'

'/mymodule/mycontroller/myaction' -> '/mvc/mymodule/controllers/mycontroller:myaction'

CRUD support

Define exports.CRUD = true; in your controller to support http methods to CRUD mapping for actions.

get: '/mymodule/mycontroller' -> '/mvc/mymodule/controllers/mycontroller:read'

post: '/mymodule/mycontroller' -> '/mvc/mymodule/controllers/mycontroller:create'

put: '/mymodule/mycontroller' -> '/mvc/mymodule/controllers/mycontroller:udpate'

delete: '/mymodule/mycontroller' -> '/mvc/mymodule/controllers/mycontroller:delete'

npm loves you