This is a starter Express.js¹ API Template, helping to get past the routine of starting a new project from scratch again and again!

This template is still in WIP phase!

• Prerequisites
• Usage
  • Build
  • Test
  • Code Style
  • Documents
    • API
    • Code
  • Config
    • Common
    • Server
    • Database
    • Sentry
  • Start
  • Docker²
• Directory Layout
• Versioning

• Node.js³ (v16.13.2 or higher)
• MongoDB⁴ (v5)

First install the dependencies:

npm i

Build the project. (Using TypeScript⁵)

npm run build

Watch for changes and rebuild automatically.

npm run build:watch

Test the project. (Using Jest⁶)

npm test

Test with code coverage report.

npm run test:coverage

Test in ci.

npm run test:ci

Check for code style issues in the project. (Using ESLint⁷)

npm run lint

Fix code style issues in the project.

npm run lint:fix

Generate the API documents to be served statically. (Using Swagger⁸)

npm run docs:swagger

Generate & serve the API documents. (The documents' server address will be printed in the terminal)

npm run docs:api

Generate the Code documents to be served statically. (Using TypeDoc⁹)

npm run docs:code

After running this command, open docs/code/index.html in your preferred browser.

First create the .env file:

cp .env.example .env

Start the API.

npm start

Watch for changes and restart automatically.

npm run start:watch

Start the services:

docker-compose up -d --build --remove-orphans

Stop the services:

docker-compose down

.
├── __tests__        # Test files
│   ├── controllers  # Express.js controller tests
│   └── jest         # Test utilities
├── docs             # Static documents
│   ├── api          # API documents
│   └── code         # Code documents
├── scripts          # Project scripts
└── src              # Source files
    ├── config       # Configuration values
    ├── constants    # Constants
    ├── controllers  # Express.js controllers
    ├── lib          # Libraries
    └── models       # Database models

We use SemVer¹¹ for versioning. For the versions & changelogs available, see the releases on this repository.