Exciting news!Announcing our $4.6M Series Seed. Learn more
Log in


Package Overview
File Explorer

Advanced tools


Library to bootstrap express applications with zero configuration


Version published
Yearly downloads
increased by52.93%

Weekly downloads



Arrow Express

Aim of this library is to make express applications bootstrapping easy and fast with zero configuration.

Main principles:

  • Use arrow functions :)
  • Avoid adding complex configuration, lib will work out of the box
  • Focus on clean functional programming, avoid usage of complex additional configuration ideas like decorators etc.
  • Flexibility and ease of use


To install package use command:

npm install arrow-express



Point of start for every application. Here you can configure Express application or port used by your application.

Example usage of application

import Express from 'express'; import {Application, Controller, Route} from 'arrow-express'; const ExpressApp = Express(); const application = Application({ app: ExpressApp }); application.configure(); ExpressApp.listen(3000);

Application Methods

  • registerController - register controller in application.
  • configure - register routes in express app.


Controller is used to manage group of routes under one prefix route.

Example usage of Controller

import {Application, Controller} from 'arrow-express'; function UserController () { return Controller() .prefix('user') .registerRoute( Route() .method('get') .handle((req, res) => { // get user and response }) ); } Application({ app: ExpressApp }) .registerControllers( UserController(), ) .configure(); // Registered path will be: GET '/user'

Controller Methods

  • prefix(prefix) - register controller prefix which will be used by all routes
  • registerRoute(route) - register route in controller
  • registerRoutes(...routes) - register multiple routes in controller
  • registerController(controller) - register sub controller in controller
  • registerControllers(...controllers) - register multiple sub controllers in controller


Route is used to manage route handling.

Example usage of route

import {Application, Controller, Route} from 'arrow-express'; Application({ app: ExpressApp }) .registerController( Controller() .prefix('user') .registerRoutes( Route() .method('get') .path('myself') .handler(async (req: Express.Request, res: Express.Response) => { const user = {}; // Use some service to extract route return user; }) ) ) .configure(); // Registered path will be: GET '/user/myself'

Route Methods

  • method - register method used for route
  • path - register path of route alongside with prefix it is used to create full path
  • handler - set request handler, here you can handle request
  • contextGuard - used to add pre-checks or side operations for request if guard throw error, handler is not called

Route handler

Route handler receive 3 arguments:

  • request - which is Express.Request for path
  • response - which is Express.Response
  • context - which is optional context returned by last guard

Features of route handler:

  • Route handler can return Promise or Object which will be send back with response code 200.
  • Route handler can also send response itself using res then library won't try to send result pf handler.
  • Route handler can also setup custom response code then arrow-express won't override it.
  • If route handler will throw RequestError, RequestError will be used to send back desired response.

Route Guard

Route Guard receive 2 arguments:

  • request - which is Express.Request for path
  • response - which is Express.Response

Route Guard can return context which can be used in handler later. If route guard throw error route handler won't be called.

Error handling

If route handler or guard throws RequestError it will be handled by arrow-express and respond with http code and response object.

import {RequestError} from "arrow-express"; throw new RequestError(401, { code: 401, message: 'Unauthorized' });


Check out example folder for example code guidance.

Use closures to structure services

Good approach is to use function closures to organize code into chunks.

Eg: create function which will return Controller and pass to it instance of service as argument instead of importing Singleton service. This way you will be able to test routes and controllers with ease without module mocking and you will avoid side effects.

// index.ts file async function startServer() { const expressApplication = Express(); const userService = new UserService(); Application({ app: expressApplication }) .registerController(UserController(userService)) .configure(); expressApplication.listen(3000); } // user.controller.ts file export function UserController(userService: UserService): ControllerConfiguration { return Controller() .prefix('users') .registerRoutes( GetUserById(userService), GetMyselfRoute(userService) ); }




Subscribe to our newsletter

Get open source security insights delivered straight into your inbox. Be the first to learn about new features and product updates.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc