Rudder
DocsGitHubChangelog

Packages

Rudder is built as a set of small, opt-in packages. The framework core is intentionally lean — every other capability ships as its own package you install only when you need it.

Pick the packages that match what you're building. Packages don't depend on each other unless they have to, and each one auto-registers its service provider when installed via pnpm rudder add <package>.

First-party packages

  • Boost — AI developer-experience layer: MCP server, per-package coding guidelines, and skill modules for Claude Code, Cursor, Copilot, Codex, Gemini, and Windsurf.
  • Cashier Paddle — Paddle billing: Billable mixin, subscription state machine, signed webhook receiver, checkout sessions, charges, refunds, drop-in React components.
  • Horizon — Queue monitoring dashboard at /horizon: per-job lifecycle, per-queue throughput / wait / runtime, worker status. Memory or sqlite storage.
  • Passport — Full OAuth 2 server: RS256-signed JWT access tokens, refresh tokens, personal access tokens, HasApiTokens mixin, RequireBearer + scope middleware.
  • Pennant — Feature flags: define flags once, check globally or per scope, gradual rollout via Lottery, route middleware, Feature.fake() for tests.
  • Pulse — Lightweight APM dashboard at /pulse: pre-aggregated request / queue / cache / exception / user / server metrics with sparklines and slow-request tables. Memory or sqlite storage.
  • Sanctum — Lightweight API token auth: opaque bearer tokens with abilities, no OAuth or JWT machinery.
  • Socialite — OAuth-based social login: built-in providers for GitHub, Google, Facebook, Apple, plus an extension point for custom OAuth providers.
  • Telescope — Debug dashboard at /telescope: records 19 entry types — requests, queries, jobs, exceptions, mail, events, cache, AI runs, MCP activity, dump(), and more.

Auth & Security

Drop-in auth strategies — pick what fits your app and ignore the rest.

@rudderjs/passport
Multi-provider OAuth + local strategies built on Passport.
@rudderjs/sanctum
Lightweight token auth for SPAs and mobile clients.
@rudderjs/socialite
Social login (Google, GitHub, Twitter, …) with a single fluent API.

Billing

Subscription management and one-off charges with first-class webhook handling.

@rudderjs/cashier-paddle
Paddle billing — Billable mixin, subscription state machine, signed webhooks, checkout, refunds, drop-in React components.

Feature Flags

Ship behind a flag — global toggles, per-scope checks, and gradual lottery rollouts.

@rudderjs/pennant
Feature flags — define a flag once, check it globally or per scope, gradual rollout via Lottery, route middleware, Feature.fake() for tests.

Database

Eloquent-inspired ORM with adapters for the SQL stack you already use.

@rudderjs/orm
Active-record models with Prisma and Drizzle adapters — relations, soft deletes, casts, observers, polymorphic morph, route-model binding.

Infrastructure

Persistence and async execution — adapters land here as they ship.

@rudderjs/queue
Background jobs with sync, BullMQ, and Inngest drivers.
@rudderjs/cache
Cache abstraction with in-memory and Redis drivers.
@rudderjs/storage
Filesystem facade — local, S3, R2, MinIO.

Communication

Email, multi-channel notifications, realtime WebSocket channels, and collaborative CRDT sync — every way clients and servers talk.

@rudderjs/mail
Mailable classes with SMTP, SES, Resend, Postmark drivers and Markdown templates.
@rudderjs/notification
Multi-channel notifications — email, database, broadcast, Slack, custom channels.
@rudderjs/broadcast
WebSocket pub/sub — public, private, and presence channels with auth.
@rudderjs/broadcast-redis
Redis pub/sub driver for @rudderjs/broadcast — multi-instance fan-out.
@rudderjs/sync
Yjs CRDT sync over WebSockets for collaborative documents and realtime app state.

Observability

Look inside your running application — requests, metrics, queues, all from one process.

@rudderjs/telescope
Development inspector — 19 watchers: requests, queries, jobs, exceptions, mail, events, AI runs, MCP, dump().
@rudderjs/pulse
Application metrics — request throughput / latency, queue metrics, cache hit rates, active users, server stats.
@rudderjs/horizon
Queue monitor — full job lifecycle, per-queue metrics, worker status, failed-job retry/delete.

AI & Tooling

Provider-agnostic agent framework with tool calling, streaming, and conversations.

@rudderjs/ai
Unified API across Anthropic, OpenAI, Google, Ollama, and more — runtime-agnostic, works in Node, browser, RN, and Electron.
@rudderjs/mcp
Expose your app as an MCP server for AI assistants to consume.
@rudderjs/boost
Wires your project into Claude Code, Cursor, Copilot, and other AI coding assistants via MCP.