Documentation

Build Realtime Apps
in Minutes

wSocket handles the realtime infrastructure so you can focus on your product. Publishers on your backend, subscribers on any frontend โ€” connected in 5 lines of code.

How it Works

Publishers on your backend โ†’ wSocket โ†’ Subscribers on any frontend

Pub/Sub
Backend Publisher
Node.js ยท Python ยท C# ยท Go ยท Java ยท PHP ยท Rust
wSocket
Pub/Sub Engine
Frontend Subscriber
Browser ยท Mobile ยท Desktop ยท IoT
Push Notifications
Your Backend
REST API / SDK
wSocket
Push Engine
User Devices
Web Push ยท FCM ยท APNs

Publishers (Backend)

Node.js / Express.js
Flask / FastAPI
ASP.NET Core (C#)
Go ยท Java ยท PHP ยท Rust

Subscribers (Frontend)

React / Next.js / Vue
Vanilla HTML / JS
React Native / Flutter
Astro ยท Svelte ยท Angular

Web Push

Browser notifications
Service Worker (VAPID)
FCM & APNs support
Broadcast & segments

Presence & History

Who's online tracking
Message history replay
Wildcard subscriptions
Delivery tracking

Real-World Use Cases

From chat to IoT โ€” wSocket powers any realtime experience

๐Ÿ’ฌ

Live Chat

Real-time messaging between users with presence indicators, typing status, and message history.

โœ…

Collaborative Todos

Shared task lists that update across all devices instantly when anyone creates, completes, or deletes a task.

๐ŸŽฌ

Live Video Comments

YouTube-style live comments and reactions that appear in real-time as users interact with video content.

๐Ÿ“Š

Dashboard Metrics

Server metrics, KPIs, and business data displayed on live dashboards that update without page refresh.

๐Ÿ””

Push Notifications

Targeted user notifications delivered instantly โ€” new messages, order updates, system alerts.

๐Ÿ“ฆ

Order Tracking

Real-time order status updates โ€” from confirmed โ†’ preparing โ†’ shipped โ†’ delivered.

๐ŸŒก๏ธ

IoT / Sensors

Stream sensor data from IoT devices โ€” temperature, humidity, motion, GPS location.

๐ŸŽฎ

Multiplayer Games

Sync game state across players โ€” positions, scores, actions, chat messages.

API Quick Reference

Connection

ws://host:9001/?key=API_KEY
WebSocket connection with API key authentication

Subscribe

{ "action": "subscribe",
  "channel": "chat:room-1" }

Publish

{ "action": "publish",
  "channel": "chat:room-1",
  "data": { "text": "Hello!" } }

Presence

{ "action": "presence.enter",
  "channel": "chat:room-1",
  "data": { "name": "Alice" } }

History

{ "action": "history",
  "channel": "chat:room-1",
  "limit": 50 }

Wildcards

Subscribe to notifications:* to receive all notification channels at once.

Ready to build?

Create a free account and start sending realtime events in under 5 minutes.