Documentation

Everything you need to go realtime with EmitWave.

Subscribe to channels over a single WebSocket, publish signed events from your server, and ship live features with typed client and server SDKs.

⌘K

Browse by topic

Pick a category to dive in.

Getting started

Understand the model, connect a client, and publish your first event in minutes.

Introduction Quickstart Authentication Channels

Core concepts

Channels, events, presence, and the signed publish path that ties them together.

Channels Events Presence Publishing

Security & delivery

Private channel authorization, end-to-end encryption, and outbound webhooks.

Encryption Webhooks Realtime auth Error codes

Client SDKs

Browser SDKs that connect, subscribe, and track presence from the frontend.

JavaScript SDK React SDK Next.js SDK Vue SDK

Server SDKs

Typed, HMAC-signing publishers for Node, Python, PHP, Laravel, Go, Ruby, Rust, and Java.

Node.js SDK Python SDK PHP SDK Laravel SDK Go SDK Ruby SDK Rust SDK Java SDK

API reference

The publish endpoint, realtime auth, and the management API.

Overview Publish event Applications Credentials

Quickstart

From zero to your first realtime event in under 5 minutes.

Create an application

Create an organization and application in the dashboard to get a public key and server credential.

Connect & subscribe

Use @emitwave/js in the browser with your public key and an end-user token to subscribe to a channel.

Publish from your server

Call trigger(channel, event, data) with a server SDK — the request is HMAC-signed automatically.

Receive in realtime

The gateway scopes the channel to your app and pushes the event to every subscriber in milliseconds.

Read the full quickstart Browse API reference

// Browser: subscribe to a channel
// $ npm install @emitwave/js

import { Emitwave } from '@emitwave/js';

const emitwave = new Emitwave('ew_pk_live_your_public_key', {
  authHeaders: async () => ({
    Authorization: `Bearer ${await getEndUserToken()}`,
  }),
});

await emitwave.connect();

const channel = await emitwave.subscribe('orders');
channel.bind('order.created', (order) => {
  console.log(order.id, order.total);
});