Endurance-template NPM

Endurance Template

Overview

The Endurance Framework is a highly modular and scalable Node.js project template built on Express.js. It is designed to dynamically load and manage independent modules, making it extremely easy to develop, extend, and maintain web applications. The goal is to create a library of ready-made modules (e.g., login, user management, etc.) that can be easily integrated into any project.

Features

Dynamic Module Loading: Easily add new modules with their own models and routes, and they will be automatically loaded and exposed by the application.
Express.js: Fast, unopinionated, minimalist web framework for Node.js.
Modular Structure: Each module is independent, promoting separation of concerns and better maintainability.
Modules marketplace: Uses npm packages starting with "EDRM-" to quickly add features to your API.
Lib assets: Include everything your need to start creating a robust API : events management, CRON, swagger, API versioning, webhooks etc.

Getting Started

Prerequisites

Node.js (v20.x)
MongoDB (optional for session management and data management)

Installation

Install our CLI:
```
npm install -g endurance
```
Create a project folder and create a new project:
```
mkdir newproject
cd newproject

endurance new
```

Usage

Start the application:
For development:
```
npm start
```
For production:
```
npm run prod
```
Add a new module:
To add a new module, create a new folder under the modules directory. Each module should contain its own models and routes.
Example structure for a new module:
```
modules/
  your-module/
    models/
      YourModel.js
    routes/
      yourModule.router.js
```
Dynamic Module Loading:
The application will automatically load and expose the routes and models from any new module added to the modules directory. There is no need for additional configuration.

Example

Here is an example of how to add a simple "login" module:

Create the module structure:

modules/
  login/
    models/
      User.js
    routes/
      login.router.js

Define the model (User.js):

const mongoose = require('mongoose');

const UserSchema = new mongoose.Schema({
  username: { type: String, required: true },
  password: { type: String, required: true }
});

module.exports = mongoose.model('User', UserSchema);

Define the route (login.router.js):

const router = require('endurance-core/lib/router')();

router.post('/login', (req, res) => {
  // Your login logic here
  res.send('Login route');
});

module.exports = router;

Testing

Run tests using Mocha and Supertest:

```bash
npm test
```

Roadmap

Library of Modules: Develop a library of ready-made modules (e.g., login, user management) for easy integration.
Enhanced Documentation: Provide detailed documentation and examples for each module.
Community Contributions: Encourage community contributions to expand the module library.