How We Do It!
Arifa is a realtime event delivery platform that enables applications to send and receive data/events/notifications instantly using WebSockets, with automatic fallback to offline persistence when users are not connected.
This documentation covers:
-
Realtime WebSocket behavior
-
HTTP notification dispatch
-
React notification UI component
-
Best practices and lifecycle management
Architecture Overview
Arifa uses a hybrid real-time model that combines WebSockets and HTTP to ensure reliable event delivery.
| Component | Purpose |
|---|---|
| WebSocket | Live delivery of notifications to connected users |
| HTTP API | Sending notifications from servers or clients |
| Persistence Layer | Stores notifications for offline users |
| Client SDK | Abstracts connection handling, subscriptions, and events |
Flow summary
-
Client connects via WebSocket using API key
-
Client subscribes to a recipient UUID
-
Server pushes events in real time
-
If recipient is offline, notifications are stored
-
Stored notifications are delivered on reconnection