Quickstart

Get your first realtime event flowing in under five minutes. Pick the language closest to your stack — Mawjly speaks the Pusher protocol, so the official SDK works unchanged.

1. Create an app


`app_id`	Public — used in REST URLs
`key`	Public — sent in WebSocket connect params
`secret`	Private — server only, signs trigger requests

2. Pick your stack

Browser / frontend

JavaScript (vanilla) — pusher-js in any frontend
React — hooks pattern
Vue — composables pattern

Server

Laravel + Echo — drop-in for Laravel’s pusher broadcast driver
PHP — pusher-php-server
Node.js — pusher npm package
Python — official pusher PyPI package

3. The four config values

Whichever SDK you use, the only Mawjly-specific changes vs. Pusher are:

- wsHost: 'ws-mt1.pusher.com',
- cluster: 'mt1',
+ wsHost: 'ws-sa.mawjly.com',
+ cluster: 'sa',
   key: 'YOUR_MAWJLY_KEY',
   forceTLS: true,

Everything else — channel APIs, auth signing, presence, encrypted channels — is identical to Pusher.

Already on Pusher?

See Migrating from Pusher — the four-config-values cheat sheet plus an .env diff.

Concepts JavaScript