Skip to main content

​
Offline Protocol Mesh SDK

The Mesh SDK is an offline-first mesh networking SDK for React Native that enables peer-to-peer messaging over BLE, WiFi Direct, and Internet with intelligent transport switching.

​
Why It Matters

In a world where connectivity is often unreliable, the Mesh SDK provides:
  • Offline-First — Works without internet connectivity using BLE mesh networking
  • Intelligent Transport Switching — Automatically selects the best transport (BLE, WiFi Direct, or Internet) using DORS
  • Mesh Networking — Messages can hop through multiple devices to reach their destination
  • Reliability — Built-in acknowledgments, retries, and deduplication ensure message delivery

​
Key Capabilities

Multi-Transport Support

Automatically switches between BLE, WiFi Direct, and Internet based on network conditions and message requirements.

Mesh Networking

Messages can hop through multiple devices, enabling communication even when devices aren’t directly connected.

DORS Technology

Dynamic Offline Relay Switch intelligently selects the optimal transport based on signal strength, congestion, energy, and reliability.

Reliability Layer

Built-in acknowledgments, exponential backoff retries, and message deduplication ensure reliable message delivery.

File Transfer

Transfer files up to 100MB with progress tracking and chunk-based delivery.

Battery-Aware

Mesh decisions consider battery levels to optimize energy consumption.

​
Requirements

PlatformVersion
React Native>= 0.70.0
iOS>= 13.0
Android>= API 26 (Android 8.0)
Node.js>= 16

​
What You Can Build

With the Mesh SDK, you can build:
  • Offline chat applications that work without internet
  • Proximity-based social apps that connect nearby users
  • Collaborative tools for teams working in areas with poor connectivity
  • Emergency communication systems that work when infrastructure fails
  • Gaming experiences with local multiplayer over mesh networks

​
Architecture Overview

The Mesh SDK uses a cluster-based architecture where devices organize into clusters of nearby connected peers. Connections between clusters are handled by bridge connections, enabling messages to traverse the entire mesh network. Key Components:
  • Protocol Core — Rust-based core handling message routing and reliability
  • BLE Manager — Handles Bluetooth Low Energy scanning and advertising
  • DORS — Dynamic transport selection system
  • Mesh Controller — Manages peer connections and cluster formation
  • Reliability Layer — Handles ACKs, retries, and deduplication

Next Steps

Get started with installation