Skip to content

shierro/node-express-boilerplate

Repository files navigation

NodeJS Express Boilerplate

Greenkeeper badge Build Status Maintainability codecov dependency status devDependency status Known Vulnerabilities

  • NodeJS boilerplate on top of express without the need to use Babel

Built-in modules/libraries

  • ExpressJS - NodeJS HTTP Framework
  • Sequelize - NodeJS ORM
  • Mogran - Express logger
  • Winston - Logs transport to console/file. Logrotate daily added
  • dotenv-safe - environment manager
  • MochaJS - Testing framework
  • Eslint - Base:AirBnB
  • Swagger - Define/Document APIs

and more

Requirements

  • NodeJS v7.0+
  • Yarn
  • Docker, docker compose/swarm for prod to maximize nginx caching & security(optional)

Install

$ git clone https://github.com/shierro/node-express-boilerplate <project_name>
$ cd <project_name> && npm i

Set your Environment vars (important)

$ cp .env.example .env

Change .env vars with your env

Dev mode

$ yarn dev

Run unit test

$ yarn test

Generate test coverage

$ yarn run cover

Prod mode w/ docker-compose

$ docker-compose up -d

Uses sequelize & sequelize-auto to handle the model layer

$ yarn generate:models

Built-in Application Monitoring

Swagger Specs