CachePuppy

Realtime and cache, together

CachePuppy gives you pub/sub topics, shared room state, and a distributed key/value cache behind one opinionated API. The server runs on the BEAM (Erlang VM) with Elixir, so you scale out by adding nodes: the runtime handles process supervision, clustering, and node-to-node coordination. Websockets fan out events across the mesh, while cache data is routed and replicated through the same cluster pipeline—so your app gets live updates and fast shared storage without bolting half a dozen products together.

Quick start

Docker, one Make target, then connect and publish from JavaScript in minutes.

Read section

Core concepts

Topics, envelopes, shared state, session data, cache tables, and how the cluster behaves.

Read section

JavaScript

Core client, React hooks, and the admin HTTP client — one chapter, three subsections.

Read section

API reference

HTTP routes, channel events, envelope fields, and TypeScript exports.

Read section

Changelog

Version notes for the server and client packages.

Read section