This is a Node.js project that implements a user CRUD system, backed by MongoDB and documented with Swagger UI. It allows users to create, read, update, and delete user data, which is stored and retrieved with the Mongoose ORM.
Additionally, the project opens a swagger documentation (http://localhost:3000/api-docs) which displays all the available requests, their description, and the methods.
- User CRUD operations (create, read, update, delete)
- Mongoose ORM for database integration
- Swagger UI for API documentation
- Third-party middlewares (helmet, xss-clean, cors, and express rate limit) for security and performance improvements
- A generic response module for all CRUD operations
- Log all errors using Winston logger
- Store logs in a file and automatically delete after 3 days
To get started with this project, follow these steps:
- Clone the repository: git clone https://github.com/m-ahmedk/node-mongo-api.git
- Install dependencies: npm install
- Start the server: npm start
- Access the Swagger UI documentation in your web browser at http://localhost:3002
To run this project, you need:
- Node.js
- MongoDB
- npm
This project uses environment variables for configuration. The following variables are required:
- MONGO_URI: the URI of the MongoDB database to use
- PORT: default port to run the local host
You can set these variables in a .env file in the root directory of the project.
Node.js Express Mongoose Winston Swagger
If you would like to contribute to the project, please reach out to the repository owner.
This project is licensed under the MIT License - see the 