// the find
SocketCluster/socketcluster
Highly scalable realtime pub/sub and RPC framework
SocketCluster is a WebSocket framework for Node.js built around async iterables, with first-class support for horizontal scaling via its SCC (SocketCluster Cluster) broker architecture. It targets teams who need real-time pub/sub or RPC at scale without pulling in a full message broker like Kafka or RabbitMQ. The async/await-native API (using `for-await-of`) is a genuine design win over callback-heavy alternatives.
Built-in horizontal scaling story using the SCC broker/state server pattern — you get multi-node pub/sub without wiring in Redis manually. The async iterable channel API is clean and maps naturally to how developers actually think about streams. Kubernetes manifests are included in the boilerplate, so the path from local dev to a clustered deployment is documented and not hand-wavy. Protocol versioning support (protocolVersion: 1) means you can migrate existing clients without a flag day.
The README is essentially a pointer to two other repos — actual documentation lives scattered across socketcluster-client, socketcluster-server, and the SCC guide, making it hard to get a complete mental model from one place. The repo itself is mostly a CLI scaffolding tool and boilerplate; the real implementation complexity is hidden in dependencies, which makes debugging non-obvious issues a spelunking exercise. Node v10 being mentioned as a baseline suggests the docs haven't been kept current. Activity is light — 6k stars but only 322 forks and slow commit cadence raises questions about whether this is actively maintained versus stable-and-done.