Skip to content

dillonstreator/template-node-fastify

Repository files navigation

template-node-fastify

A minimal production-ready node HTTP server with Fastify 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
✅ Auto-generated Swagger/OpenAPI documentation
AbortSignal propagation to prevent unnecessary work (includes example and test)
✅ Structured logging with pino
✅ Rich request logging middleware including request id, trace id, context propagation, and more
zod for request validation, JSON schema inference, and OpenAPI/Swagger generation
✅ Testing with tap and undici
helmet & compression

Deploy on Railway

Installation

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

cd template-node-fastify

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