gRPC + ConnectRPC for Node.js

A clear path from your first RPC to production

Connectum gives TypeScript teams a consistent service runtime for contracts, middleware, security, observability, and operations—without hiding the controls.

Build your first service Find an API

Docs: 1.3.x
Compatibility: Runtime matrix

Start by goal

Use the shortest route to your outcome.

New to ConnectumBuild a first serviceGo from an empty directory to a verified gRPC call with a focused, linear tutorial.Start the tutorial Building a capabilitySolve a service taskAdd validation, communication, events, authentication, or testing without reading the whole framework.Browse guides Operating servicesPrepare for productionConnect health, observability, graceful shutdown, containers, Kubernetes, and gateways.Explore operations Know what you needFind an exact optionJump by module or symbol into the generated API, compatibility matrix, or migration guidance.Open reference

One service lifecycle

Compose only the capabilities you need.

The framework keeps lifecycle and registration predictable while modules remain explicit. Begin with the server; add production behavior as the service grows.

01DefineProto contracts and generated types
02RunServer lifecycle and transport
03ProtectValidation, auth, and resilience
04ObserveTraces, metrics, and logs
05OperateHealth, shutdown, and deployment

Fits your stack

One runtime across your service ecosystem.

Build on ConnectRPC and gRPC, operate with cloud-native tooling, and choose the brokers and runtimes that fit each service.

ConnectRPC
gRPC
Kubernetes
Istio
OpenTelemetry
RabbitMQ
Kafka
NATS
Redis
KeyDB
Dragonfly
AMQP
Redpanda
TypeScript
Bun
Node.js
pnpm

The central primitive

A server whose production behavior stays visible.

Services, protocols, middleware, and shutdown policy meet at createServer(). The full tutorial defines the proto, implements the handler, starts the service, and verifies a real RPC.

Follow the full tutorial →CreateServerOptions →

server.ts

typescript

import { createServer } from '@connectum/core';
import { Healthcheck } from '@connectum/healthcheck';
import { createDefaultInterceptors } from '@connectum/interceptors';
import { Reflection } from '@connectum/reflection';
import { greeterService } from './services/greeterService.ts';
const server = createServer({
  services: [greeterService],
  port: 5000,
  protocols: [Healthcheck({ httpEnabled: true }), Reflection()],
  interceptors: createDefaultInterceptors(),
  shutdown: { autoShutdown: true },
});
await server.start();

Explore modules

Navigate by capability, not dependency graph.

Each module links learning material, focused configuration, and its generated API surface.

Foundation

@connectum/core

Server lifecycle, service registration, configuration, TLS, and in-process clients.

createServer · defineService · createCatalogClient

A clear path from your first RPC to production

Use the shortest route to your outcome.

Compose only the capabilities you need.

One runtime across your service ecosystem.

A server whose production behavior stays visible.

Navigate by capability, not dependency graph.

Foundation

Security

Communication

Operations

Tooling and testing

From evaluation to operation.