A ready-to-use boilerplate for REST API Development with Node.js, Express, and MongoDB

This is a basic API skeleton written in JavaScript ES2015. Very useful to building a RESTful web APIs for your front-end platforms like Android, iOS or JavaScript frameworks (Angular, Reactjs, etc).

This project will run on NodeJs using MongoDB as database. I had tried to maintain the code structure easy as any beginner can also adopt the flow and start building an API. Project is open for suggestions, Bug reports and pull requests.

• Basic Authentication (Register/Login with hashed password)
• Account confirmation with 4 (Changeable) digit OTP.
• Email helper ready just import and use.
• JWT Tokens, make requests with a token after login with Authorization header with value Bearer yourToken where yourToken will be returned in Login response.
• Pre-defined response structures with proper status codes.
• Included CORS.
• Book example with CRUD operations.
• Validations added.
• Included API collection for Postman.
• Light-weight project.

• Node.js 10+
• MongoDB 3.6+ (Recommended 4+)

1. Clone the project from github. Change "myproject" to your project name.

git clone https://github.com/maitraysuthar/rest-api-nodejs-mongodb.git ./myproject

1. Download repository
2. Uncompress to your desired directory

cd myproject
npm install
npm update

1. You will find a file named .env.example on root directory of project.
2. Create a new file by copying and pasting the file and then renaming it to just .env
3. The file .env is already ignored, so you never commit your credentials.
4. Change the values of the file to your environment. Helpful comments added to .env.example file to understand the constants.

npm run dev

You will know server is running by checking the output of the command npm run dev

Connected to mongodb:YOUR_DB_CONNECTION_STRING
App is running ...

Press CTRL + C to stop the process.

Note: YOUR_DB_CONNECTION_STRING will be your MongoDB connection string.

If you need to add more models to the project just create a new file in /models/ and use them in the controllers.

If you need to add more routes to the project just create a new file in /routes/ and add it in /routes/api.js it will be loaded dynamically.

If you need to add more controllers to the project just create a new file in /controllers/ and use them in the routes.

Every project needs improvements, Feel free to report any bugs or improvements. Pull requests are always welcome.

This project is open-sourced software licensed under the MIT License. See the LICENSE file for more information.