primus/primus

Health v2 · maintenance only

Adoption not part of the score

4469 stars · 270 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Primus is a Node.js abstraction layer over multiple real-time frameworks (WebSocket, SockJS, Engine.IO, BrowserChannel, polling) that exposes a single unified client/server API. It adds built-in reconnect with exponential back-off, offline detection, pluggable message encoders, and a stream-compatible interface so frameworks can be swapped by changing one line of code.

Use cases

• add real-time messaging to a node.js app without locking into socket.io
• switch websocket frameworks without rewriting client and server code
• implement automatic reconnection with exponential back-off for live connections
• broadcast messages to connected clients over websockets
• use the same realtime client code in the browser and node.js
• encode realtime messages with a custom parser or binary format

When to choose

• you want framework-agnostic real-time communication on Node.js with easy transformer swapping
• you need built-in reconnect, offline detection, and stability patches across transports
• you want a stream-compatible realtime interface and plugin system

When to avoid

• you are happy with a single framework like socket.io and don't need abstraction
• you need a non-JavaScript backend language
• you require a project with frequent recent releases and active development

Facets

library · maturity maintenance

websocket middleware serialization plugin-system web-development backend developer-tools browser cross-platform real-time abstraction-layer sockjs engine-dot-io browserchannel polling pubsub reconnect transformers nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="primus/primus")