This project provides a robust API skeleton written in JavaScript ES6, suitable for any project. It offers features such as authentication, authorization, JWT tokens, role management, CRUD operations, email notifications, and more. Additionally, it automates the generation of CRUD (Create, Read, Update, Delete) operations for entities within a MongoDB database, streamlining the development process for Node.js applications built on top of Express.js.

• Getting Started
• Features
• Software Requirements
• Engines
• How to Install
• Setting up Environments
• Project Structure
• How to Run
• CLI Commands
• Linting and Formatting
• Bugs or Improvements
• License
• Credits
• Support

This is a basic API skeleton written in JavaScript ES6.

This project will run on NodeJs using MongoDB as database.

API Documentation [Swagger]

• Authentication and Authorization
• JWT Tokens, make requests with a token after login with Authorization header with value Bearer yourToken where yourToken will be returned in the Login response.
• Role Manage
• Update Profile/Password User Account
• Upload Image with multer
• Reset Password Mail using nodemailer
• Pre-defined response structures with proper status codes.
• Included CORS.
• System notification with Firebase
• Email Template and settings
• Validations added.
• Included API collection for Postman.
• Light-weight project.
• Linting with Eslint. (Airbnb style)
• Included CLI for generating CRUD operations.
• husky for pre-commit hooks and lint-staged for running linters on git staged files.

• Node.js 16+
• MongoDB 4+

• node >=14.16.0 <=20.11.0
• npm >=6.14.11 <=10.2.4

1. Clone the project from github.

git clone https://github.com/fadhlaouir/express-node-starter.git

1. Download repository
2. Uncompress to your desired directory

cd express-node-starter
npm install

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

   cp .env.example .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.

.
├── .husky
│   ├── _
│   │   ├── .gitignore
│   │   └── husky.sh
│   ├── pre-commit
│   └── pre-push
├── cli
│   ├── _
│   │   ├── deleteCrud.js
│   │   ├── generateEmptyCrud.js
│   │   ├── generateMinimalCrud.js
│   │   └── helpers.js
│   ├── index.js
│   └── README.md
├── src
│   ├── controllers
│   │   ├── auth.controller.js
│   │   └── user.controller.js
│   ├── middlewares
│   │   ├── multer.js
│   │   └── verify-token.js
│   ├── models
│   │   └── user.model.js
│   ├── routes
│   │   ├── auth.route.js
│   │   └── user.route.js
│   ├── template
│   │   └── userAccountEmailTemplates.js
│   ├── utils
│   │   └── helpers.js
│   └── swagger.json
├── .commitlintrc.json
├── .editorconfig
├── .env
├── .env.example
├── .eslintignore.json
├── .eslintrc.json
├── .gitignore
├── .prettierignore.json
├── .prettierrc.json
├── CHANGELOG.md
├── LICENSE
├── package.json
├── README.md
└── server.js

If you would like to run the API server on your local environment, you can do so by running the following command: Windows OS

npm run develop

Linux OS or Mac OS

npm run develop:mac

Connected to the database:YOUR_DB_CONNECTION_STRING
App is running ...

Press CTRL + C to stop the process.

Note:

YOUR_DEVELOPMENT_DB_CONNECTION_STRING will be your MongoDB connection string for development environment.

YOUR_PRODUCTION_DB_CONNECTION_STRING will be your MongoDB connection string for production environment.

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

If you need to add more routes to the project just create a new file in src/routes/ and import it in src/app to be loaded.

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

1. Navigate to the project directory.
2. Run the following command:

npm run crud:operation

See the CLI README section for more details on how to use the CLI to generate or delete CRUD operations.

Follow the prompts to select the CRUD type (empty or minimal) and provide the entity name. The tool will generate the necessary files for the CRUD operations based on your selection.

npm run lint:check

npm run lint:fix

npm run format:fix

You can set custom rules for eslint in .eslintrc.json file, Added at project root.

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.

• Raed FADHLAOUI: Author Email
• Project Repository: GitHub Repository

If you find this project valuable, consider supporting us through Buy Me a Coffee. Your sponsorship helps us maintain and improve the project, ensuring better features, updates, and support for the community.