Introduction
ravex is a production-ready, fully-typed real-time chat system for Node.js. Built on Socket.IO with first-class TypeScript support.
ravex
Type-safe real-time chat for any Node.js server.
ravex gives you everything you need to build modern chat experiences — presence, typing indicators, reactions, read receipts, and robust moderation — with excellent developer experience and zero lock-in.
The Three Packages
ravex is split into three packages that work together:
@ravex/server— The core chat engine. Attach it to any Node.js HTTP server (Express, Fastify, NestJS, Hono, Koa, or plainhttp).@ravex/client— The frontend SDK. A clean, promise-based wrapper aroundsocket.io-clientwith full TypeScript inference.
Why ravex?
- Framework agnostic — Works with any Node.js server
- End-to-end TypeScript — Every event, payload, and method is fully typed
- Batteries included — Presence, typing, reactions, read receipts, rate limiting
- Extensible — Pluggable persistence adapters for PostgreSQL, MongoDB, Redis, etc.
- Battle-tested patterns — Built on top of the proven Socket.IO ecosystem
Quick Links
Get Started
Installation and a minimal end-to-end example
Server SDK
ChatEngine, configuration, and framework integrations
Client SDK
Promise-based API and real-time event listeners
Next Steps
- Getting Started — Install and run your first chat server + client in minutes.
- Server Documentation — Deep dive into the backend engine.
- Client Documentation — Everything you need on the frontend.