express-recursive-routes

Recursively configure Express.js routes in a folder. It uses sensible defaults (filenames) but can be easily customized.

Usage

express-generator creates routes under /routes folder, but you have to manually register routes like this:

var index = require('./routes/index');
var users = require('./routes/users');

app.use('/', index);
app.use('/users', users);

With express-recursive-routes you can let function mountRoutes() do the magic:

const routeUtils = require('express-recursive-routes');
routeUtils.mountRoutes(app);

Configuration

If your setup is different, you can pass configuration parameters to mountRoutes():

• rootDir: folder containing route files. Defaults to ./routes
• basePath: prefix path added to all routes. Defaults to '' (empty)
• filter: search for filenames containing this string
  • defaults to .js
  • strips filter from route path
  • it always strips the trailing .js suffix

Logging

You can activate various logging levels setting EXPRESS_RECURSIVE_ROUTES_LOG_LEVEL environment variable. Valid values are:

• ERROR (default)
• WARN
• INFO
• DEBUG

Example 1: custom routes folder

If your routes files are stored in a folder different from routes, for example:
src/my-routes

you can configure them like this:

routeUtils.mountRoutes(app, './src/my-routes');

Example 1: custom prefix path

Sometimes you want your routes to have a special prefix, for example /api:

routeUtils.mountRoutes(app, null, '/api');

---

Development

Install semantic-release-cli:

npm install -g semantic-release-cli
semantic-release-cli setup

Commit using commit script (commit-zen):

npm run commit