Skip to main content
Healthzkit is a small, framework-agnostic library for Kubernetes-style liveness and readiness probes in Node.js. You define checks as adapters that return ok, degraded, or fail. Healthzkit runs the relevant checks in parallel, rolls up an overall status, maps that to an HTTP response, and can schedule slow checks in the background so probes read cached results.

Get started

Install healthzkit and wire /healthz/live and /healthz/ready.

Framework guides

Hono, Express, Fastify, Elysia, Next.js, and Node http.

Checks and adapters

Timeouts, failure mapping, and official adapter packages.

Scheduling

Cache expensive probes so kubelet does not stampede your database.

What you get

Liveness and readiness

Tag checks for liveness, readiness, or both. Kubernetes-style /healthz/live and /healthz/ready, with per-check timeouts and a clear rollup to 200 or 503.

Fetch, Hono, Express, Next.js

toFetchResponse and createFetchHandler map onto Fetch APIs. Framework guides cover Express, Fastify, Hono, Elysia, and Next.js App Router.

Background scheduling

Run expensive checks on an interval and serve probes from cache so kubelet does not stampede Postgres on every poll.

Official adapters

Postgres, Redis, Valkey, MySQL, MongoDB, SQLite, Kafka, RabbitMQ, S3, DynamoDB, Elasticsearch, Drizzle, Prisma, HTTP, and more — install only the clients you already use.

Install

The package is ESM-only. Published packages declare Node.js 22.12+.
New here? Start with the introduction, then copy a Hono or Fetch handler.