Websocket RouterA public address space for realtime messages

Connect a websocket to any URL. Everything you send goes to every other client on that URL — and to nobody else. No accounts, no SDK, no setup.

Quickstart

What is this?

GitHub

🔌

A channel is just a URL

No provisioning step, no create call, no config. Pick a name nobody can guess, connect, and the channel exists for as long as someone is listening.

How channels work

↔️

Everyone but the sender

The single rule of the router. Peers can broadcast into a channel without having to filter out their own echo, which is what makes symmetric peer-to-peer app code trivial.

How messages flow

📨

Bring your own payload

Strings in, the same strings out. JSON, CSV, base64, a single emoji — the router never parses, validates or transforms what you send.

The whole API

🌍

Scales past one process

Instances share channels over redis pub/sub, so it does not matter which server your clients happen to land on. Add instances, the routing keeps working.

Architecture

🧩

Made for gluing things together

Phone to laptop, tab to tab, script to browser, iframe to iframe. Especially good at connecting components that were never designed to know about each other.

Use cases

⚖️

Honest about the trade-offs

No persistence, no replay, no delivery guarantees, no auth beyond the secrecy of the channel name. Ephemeral by design, and documented as such.

Guarantees & limits

In thirty seconds

const ws = new WebSocket(
  "wss://router.metapage.io/a-name-nobody-will-guess",
);

// Anything any other client sends to that URL arrives here.
ws.onmessage = (event) => console.log("peer said:", event.data);

// Anything we send goes to all of them — but never back to us.
ws.onopen = () => ws.send(JSON.stringify({ hello: "world" }));

And from anything that can make an HTTP request:

curl -X POST \
  https://router.metapage.io/a-name-nobody-will-guess \
  -d '{"temperature": 21.4}'

That is the entire product surface. The rest of these docs is about what that turns out to be good for, and where the edges are.