Minimalist modular backend development

Modular Node.js backend development, management, and orchestration of backend applications.

It promotes a clean separation of concerns by structuring applications into distinct functional units, called "divisions".

• 🧩 Modular Design: Clean architectural separation into distinct divisions.
• 🔗 Dependency Management: Ensures correct initialization order of divisions.
• ✅ Environment Variables Validation: JSON Schema validation for environment variables.
• 🖥 CLI Integration: Defines and executes division-specific commands.
• 🍃 Dynamic Lifecycle Management: Custom setup and teardown routines for resource management.

In complex applications, managing configurations, dependencies, and initialization order can become challenging.

Divisions was created to address these challenges by offering a structured way to organize application logic into manageable, isolated modules.

This approach not only improves code maintainability but also enhances the development workflow by providing clear interfaces for each part of the application.

Inspired by the modular philosophy, Divisions aims to bring simplicity, clarity, and efficiency to backend application development.

Node.js version 20.11.0 or higher is required.

Install divisions via npm/yarn/pnpm:

npm install divisions

Our goal is to create a division called http to create our http server.

1. Create the divisions directory. It will contains all our divisions directories.
2. Create your first division directory divisions/http.
3. Create divisions/http/index.js with the following content:

// divisions/http/index.js
import http from "node:http";

export const meta = {
  // Define environment variables schema for validation
  envSchema: {
    type: "object",
    properties: {
      PORT: { type: "integer" },
    },
    required: ["PORT"],
  },
};

// Define division setup
export function setup({ config }) {
  const httpServer = http.createServer((_request, response) => {
    response.writeHead(200, { "Content-Type": "text/plain" });
    response.end("Hello from http division 👋");
  });

  return {
    // On start `http` division
    start() {
      httpServer.listen(config.PORT, () => {
        console.info(`HTTP Server running at http://localhost:${config.PORT}`);
      });

      return {
        // Close `http` division in a clean way
        cleanup() {
          httpServer.close();
          console.info("HTTP Server has been closed");
        },
      };
    },
  };
}

4. Create a .env file at the root of your project containing all environment variables used by our divisions.

PORT=3000

5. Create index.js to start divisions. This operation will import your divisions and execute them.

import { startDivisions } from "divisions";

startDivisions().catch(console.error);

By the end, your project structure should look like this:

.
├── divisions
│   └── http
│       └── index.js
├── index.js
├── package.json

6. Launch it !

❯ node index.js
HTTP Server running at http://localhost:3000

❯ curl http://localhost:3000
Hello from http division 👋

Contributions are welcome! Submit issues, feature requests, or pull requests 🤝.

Made with 💚

Published under the MIT license.

Inspired by the modular design philosophy and contributions to the open-source Node.js ecosystem by developers worldwide 🙌