template-node-express

A minimal production-ready node HTTP server with Express and Typescript.

✅ Typescript
✅ Graceful shutdown
✅ Optional Tracing with OpenTelemetry (configurable via environment variables)
✅ Properly configured request payload size limiting to help prevent Denial of Service attack vectors
✅ AbortSignal propagation to prevent unnecessary work (includes example and test)
✅ Validation with express-validator
✅ Async error forwarding to default error handler with express-async-errors
✅ Structured logging with pino
✅ Rich request logging middleware including request id, trace id, context propagation, and more
✅ Testing with jest, supertest, and fetch-mock
✅ helmet & compression

Installation

git clone https://github.com/dillonstreator/template-node-express

cd template-node-express

yarn install

yarn dev

Configuration

See all example configuration via environment variables in .env-example

Open Telemetry

Open Telemetry is disabled by default but can be enabled by setting the OTEL_ENABLED environment to true.

By default, the trace exporter is set to standard output. This can be overridden by setting OTEL_EXPORTER_OTLP_ENDPOINT.

Start the jaegertracing/all-in-one container with docker-compose up and set OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 to collect logs in jaeger. Docker compose will expose jaeger at http://localhost:16686