ExpressDirectoryRouter is a lightweight and flexible middleware for Express.js that simplifies routing by automatically handling routes based on the structure of your project directories.

• Installation
• Usage
  • JavaScript
  • TypeScript
  • Middleware
  • Directory-Routes
  • Route-Functions
• Documentation
• Contributing
• License

You can install ExpressDirectoryRouter using npm, yarn, or pnpm for example:

npm install @kyri123/express-directory-router

yarn add @kyri123/express-directory-router

pnpm add @kyri123/express-directory-router

To use ExpressDirectoryRouter, simply require it and use it as middleware in your Express application:

const express = require('express');
const { installAppExpress } = require('express-directory-router');

const app = express();

// install routings with default settings
installAppExpress(app).then(() => {
	app.listen(3000, () => {
		console.log('Server is running on http://localhost:3000');
	});
});

import express from 'express';
import { installAppExpress } from 'express-directory-router';

const app = express();

// install routings with default settings
installAppExpress(app).then(() => {
	app.listen(3000, () => {
		console.log('Server is running on http://localhost:3000');
	});
});

Middleware can be used in the following formats the name of the file must ne middleware.(js|ts) Following named exports are supported:

• GET
• POST
• PUT
• DELETE
• PATCH
• GLOBAL -> GLOBAL is a special middleware that is executed for all routes and methods (also in subdirectories)
• WILDCARD -> WILDCARD is a special middleware that is executed for all routes and methods (BUT NOT in subdirectories)
• HEAD
• OPTIONS
• ALL
• TRACE

import { type MiddleWareInit } from '@kyri123/express-directory-router';

export const GET: MiddleWareInit = async (payload) => {
	return [
		(req, res, next) => {
			return next();
		}
	];
};

export const GLOBAL: MiddleWareInit = async (payload) => {
	return [
		(req, res, next) => {
			return next();
		}
	];
};

Route the directory structure is as follows:

Routes can be used in the following formats the name of the file must ne ('get'|'post'|'put'|'delete'|'all'|'head'|'connect'|'options'|'trace').(js|ts): named exports:

• middleware -> (optional) - Middleware for the route (see Middleware)
• default -> (required) - The route handler must be a RoutingFunction

```ts
import { ResponseStatus, jsend, type MiddleWareInit, type RoutingFunction } from '@kyri123/express-directory-router';

export const middleware: MiddleWareInit = async (payload) => {
	return [
		(req, res, next) => {
			return next();
		}
	];
};

const handler: RoutingFunction = async ({ response, request, next, payload }) => {
	response.status(200).json(
		jsend(ResponseStatus.Success, {
			data: { message: 'Hello World' }
		})
	);
};

export default handler;

You can find the detailed documentation for ExpressDirectoryRouter in the docs directory.

We welcome contributions! If you find a bug or have an idea for a new feature, please open an issue or submit a pull request.

Please make sure to follow our code of conduct.

This project is licensed under the MIT License - see the LICENSE file for details.

Thanks to the contributors of Express.js for providing a powerful web application framework.