This is a boilerplate for building scalable and robust REST APIs using Node.js & TypeScript.

• Prerequisites
• Features
• Getting Started
  • Installation
  • Directory Structure
  • Available Routes
  • Available Scripts
• License

You need to install MongoDB either on your local machine or using a cloud service as mLab.

• TypeScript as Language

• Framework: Express.js

• ODM: Mongoose

• Linting and formatting code using TSLint & Prettier

• Authentication & Authorization with JSON Web Tokens

• Easy configuration of environment variables thanks to dotenv

• EditorConfig for maintain consistent coding style

• Morgan for logging request

• Using the last ES6 / ES7 features as async-await

• Versioned routes for better scalability

1. install the dependencies using npm install or npm i

2. Rename the file .env.example to .env, then you need to configure the file config.ts located in src/config

3. Start the app using npm run dev

4. After that, go to: http://localhost:3000/v1/users

├── src
│   ├── apiV1
│   │   ├── auth
│   │   │  ├── auth.controller.ts
│   │   │  └── auth.route.ts
│   │   ├── users
│   │   │   ├── user.controller.ts
│   │   │   ├── user.controller.ts
│   │   │   └── user.route.ts
│   │   └── index.ts
│   ├── config
│   │   ├── config.ts
│   │   └── db.ts
│   ├── helpers
│   │   ├── errorHandler.ts
│   │   └── verifyToken.ts
│   ├── .env.example
│   ├── App.ts
│   └── index.ts
├── .editorconfig
├── .gitignore
├── package.json
├── README.md
├── tsconfig.json
└── tslint.json

• build - Transpile TypeScript to ES6,
• lint - Lint your TS code,
• dev - To run the app without transpile to ES6,
• clean - Remove dist, node_modules, coverage folders,
• start - Run the transpiled app
• prod - Build & run the transpiled app

MIT © Michael Méndez