Skip to content
Node Express Conventions
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Node Express Conventions

nodule-express aims to define basic routes for Node Express gateways to focus on definiing logic for actual API endpoints and leave basic error handling and express set up to this library


By importing nodule-express, the following bindings are made available.


  • middleware.basicAuth injects a basic auth middleware


  • returns an Express instance
  • returns a microcosm-compatible health check endpoint
  • routes.notFound return a 404-generating endpoint
  • routes.unauthorized return a 401-generating endpoint


  • install: Install dependencies and save to yarn.lock file
  • lint: Runs airbnb flavored eslint
  • build: Runs tests and transpiles ES6 -> ES5
  • test: Runs tests


Endpoints should throw errors when something fails. Within nodule-express, it is expected that:

  • All errors define code that can be used by API consumers for error handling business logic
  • Most errors will borrow from HTTP error codes (because they have well-known, useful semantics)
  • Error codes should be visible to API consumers via error.extensions

Local Development

Local development of nodule-express with other repos has a few common pitfalls related to the usage of peer dependencies:

  • nodule-config is a peer-dependency because various libraries act as plugins to it and it needs a single import of bottlejs to share plugin state

To work with nodule-express locally:

  1. Run yarn build within nodule-express to transpile the source.

  2. Change directories to your local repo that you want to test against nodule-express.

  3. Run yarn add /path/to/nodule-express to copy the transpiled source into your local repo. Do NOT use yarn link

  4. After running yarn add, remove (or move-of-the-way) the nodule_modules from within nodule_modules/@globality/nodule-express/

You can’t perform that action at this time.