gRPC + ConnectRPC for Node.js

From your first RPC to operating a service

Connectum provides a TypeScript service runtime for proto contracts, request middleware, security, observability, and operations.

Build your first service Find an API

Docs: 1.3.x
Compatibility: Runtime matrix

Start by goal

Choose a path for the task at hand.

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, service calls, events, authentication, or testing with a guide for the task at hand.Browse guides Operating servicesDeploy and operate servicesConfigure health checks, observability, shutdown, containers, Kubernetes, or a gateway.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

Add capabilities through explicit modules.

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

Choose a runtime for each service.

Use ConnectRPC or gRPC, connect to supported brokers, and choose Node.js or Bun for each service.

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

The central primitive

Compose a service with an explicit lifecycle.

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

Find modules by capability.

Each module links to its guide, configuration help, and generated API reference.

Foundation

@connectum/core

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

createServer · defineService · createCatalogClient

From your first RPC to operating a service

Choose a path for the task at hand.

Add capabilities through explicit modules.

Choose a runtime for each service.

Compose a service with an explicit lifecycle.

Find modules by capability.

Foundation

Security

Communication

Operations

Tooling and testing

From evaluation to operation.