Install

npm i @expressots/adapter-express

What This Package Does

This adapter bridges ExpressoTS Core and Express.js. It provides the HTTP server implementation, route registration, middleware pipeline, and the App class that wires everything together. Install it alongside @expressots/core to run ExpressoTS on Express.

Quick Look

import { AppExpress } from "@expressots/adapter-express";
import { AppContainer, CreateModule, bootstrap } from "@expressots/core";
import { AppController } from "./app.controller";

export class App extends AppExpress {
  private readonly container: AppContainer = this.configContainer([
    CreateModule([AppController]),
  ]);

  async configureServices(): Promise<void> {
    // register middleware, interceptors, error handlers
  }
}

void bootstrap(App); // starts on process.env.PORT or 3000

bootstrap() builds the container, runs the AppExpress lifecycle hooks (globalConfiguration, configureServices, postServerInitialization), starts the HTTP server, and wires graceful shutdown on SIGINT / SIGTERM.

Requirements

• Express 5 (the adapter targets the Express 5 API; body parsing uses the Express 5 native parsers)
• Node.js >= 20.19.0
• @expressots/studio-agent is an optional peer dependency: install it to enable ExpressoTS Studio integration, or omit it with no impact on the adapter.

Preview modules

The micro-api module (gateway, service-mesh, serverless, queue) is preview quality: its APIs may change and it is not yet covered by the test suite. Use it for experimentation, not production-critical paths.

Documentation

For guides, API reference, architecture patterns, and examples visit doc.expresso-ts.com.

Contributing

Welcome to the ExpressoTS community. See the Contributing Guide for how to get involved.

Support the project

• GitHub Sponsors
• Star the organization on GitHub
• Discord
• Report an issue

License

MIT. See LICENSE.