Ethora — SDK Monorepo
Chat, AI and messaging SDK platform. Add real-time messaging, AI bots, and backend services to your app in minutes.
This repository serves as the SDK monorepo — a single place to discover, clone, and navigate all Ethora SDKs, tools, and sample apps. Each component lives in its own focused repository, linked here as git submodules.
Ecosystem
| Folder | Repository | Description | Status |
|---|---|---|---|
sdk-reactjs/ |
ethora-chat-component | React.js chat SDK — embed chat in any web app | Active |
sdk-reactnative/ |
ethora-chat-component-rn | React Native chat SDK (iOS & Android) | Active |
sdk-android/ |
ethora-sdk-android | Native Android SDK (Kotlin) | Active |
sdk-swift/ |
ethora-sdk-swift | Native iOS SDK (Swift) | Active |
sdk-wordpress/ |
ethora-wp-plugin | WordPress plugin — no-code chat widget | Active |
app-reactjs/ |
ethora-app-reactjs | Full web app (React.js) — App Builder frontend | Active |
playground/ |
ethora-sdk-playground | SDK testing & demo playground | Active |
backend-integration/ |
ethora-sdk-backend-integration | Backend integration examples | Active |
mcp-cli/ |
ethora-mcp-server | MCP CLI for IDE/agent integration | Active |
rag-demos/ |
rag_demos | RAG pipeline demos & examples | Active |
bots/ |
ethora-bots | Bot framework (XMPP, LLM, automation) | Active |
setup/ |
ethora-setup | CLI setup tool — npx @ethora/setup |
Active |
api/ |
(inline) | REST API documentation (Swagger/OpenAPI) | Reference |
| — | ethora-app-react-native | React Native app (iOS & Android) | Legacy |
| — | site_crawler | Website crawler for RAG ingestion | Active |
Feature coverage across SDKs
Quick glance at what each SDK supports. Full matrix with evidence: features/ · Source:
features/features.yaml
| Capability | React.js | React Native | Android | iOS | WordPress |
|---|---|---|---|---|---|
| Email/password login | ✅ | ✅ | ✅ | ✅ | — |
| JWT / custom-token login | ✅ | ✅ | ✅ | ✅ | — |
| OAuth / social login | ✅ | 🟡 | 🛠 | 🟡 | 🟡 |
| Text messaging (send/edit/delete/reply) | ✅ | ✅ | ✅ | ✅ | 🟡 |
| Reactions | ✅ | — | ✅ | ✅ | — |
| Typing indicator | ✅ | ✅ | ✅ | ✅ | — |
| Delivery status indicators | ✅ | — | — | ✅ | — |
| Message history (MAM pagination) | ✅ | ✅ | ✅ | ✅ | — |
| Images / video / files / audio | ✅ | ✅ | ✅ | ✅ | — |
| 1:1 messaging | ✅ | ✅ | ✅ | ✅ | 🟡 |
| Group rooms (MUC) | ✅ | ✅ | ✅ | ✅ | — |
| Single-room (embedded widget) mode | ✅ | ✅ | ✅ | ✅ | ✅ |
| Unread counter | ✅ | ✅ | ✅ | ✅ | — |
| Push notifications | ✅ | 🟡 | ✅ | ✅ | — |
| In-app notifications | ✅ | — | 🟡 | 🟡 | — |
| Prebuilt chat UI | ✅ | ✅ | ✅ | ✅ | ✅ |
| Theming | 🟡 | 🟡 | ✅ | ✅ | — |
| Dark mode | — | — | ✅ | — | — |
| Custom component overrides | ✅ | ✅ | ✅ | 🟡 | — |
| Self-hosted server support | ✅ | ✅ | ✅ | ✅ | ✅ |
| Offline message cache | ✅ | 🟡 | ✅ | ✅ | — |
Legend: ✅ Present · 🟡 Partial · 🛠 Roadmap · — Absent
Coverage (present + partial×0.5) / 44 features: React.js 77% · Android 76% · React Native 68% · iOS 68% · WordPress 14%
Last reviewed 2026-04-21 (v26.04). Monthly AI-reviewed update proposed via PR.
Hosted services
These public services run on the Ethora Cloud and are useful when exploring or testing the platform — no setup required.
| Service | URL | What it is |
|---|---|---|
| Web app | app.chat.ethora.com | Sign up, create apps, get API credentials, manage chats and AI bots. |
| API | api.chat.ethora.com | REST API used by all SDKs. |
| API docs (Swagger) | api.chat.ethora.com/api-docs/#/ | Live, up-to-date OpenAPI / v2 routes. |
| XMPP | wss://xmpp.chat.ethora.com:5443/ws |
Real-time messaging gateway. |
| SDK Playground | playground.chat.ethora.com | Live @ethora/chat-component playground, code export, HTTP testing. |
| Uptime / status | uptime.chat.ethora.com | Public uptime and journey checks for the Ethora platform. |
| Documentation | API docs | REST API reference. Guides and SDK docs: ethora.com/chat-sdk and ethora.com/ai-sdk. |
| QA environment | chat-qa.ethora.com | Pre-production QA environment (use for pre-release validation only; chat.ethora.com remains the canonical default for everything else). |
Getting Started
Clone with all submodules
git clone --recurse-submodules https://github.com/dappros/ethora.git
cd ethora
If you already cloned without --recurse-submodules:
git submodule update --init --recursive
Automatic submodule bumps
This repo can update its submodule pointers automatically via .github/workflows/bump-submodules.yml.
Behavior:
- runs every 6 hours on weekdays and on manual dispatch
- updates each submodule to the latest commit on its remote default branch
- commits pointer bumps directly into
main
Set up credentials (recommended)
npx @ethora/setup
This will create an account, set up an app, and generate config files for your target SDK. You can also connect to a self-hosted server.
Quick paths
Add chat to a website (fastest):
cd sdk-reactjs
npm install
# See sdk-reactjs/README.md for embedding instructions
Add chat to a React Native app:
cd sdk-reactnative
npm install
# See sdk-reactnative/README.md
Native Android SDK:
cd sdk-android
# See sdk-android/README.md for Gradle setup
Native iOS SDK:
cd sdk-swift
# See sdk-swift/README.md for Swift Package Manager setup
WordPress (no code):
Install the plugin from sdk-wordpress/ or see ethora-wp-plugin.
Connect via MCP (IDE/AI agent):
cd mcp-cli
npm install
# See mcp-cli/README.md
Default backend
Sign up for a free account at app.chat.ethora.com to get API credentials. The SDKs connect to Ethora Cloud by default. Self-hosted and dedicated server options are available for enterprise customers.
Canonical default endpoints (used by all official SDKs unless overridden):
| Purpose | Default value |
|---|---|
| API base URL | https://api.chat.ethora.com |
| API base URL (versioned) | https://api.chat.ethora.com/v1 (legacy), https://api.chat.ethora.com/v2 (current) |
| Swagger / API docs | https://api.chat.ethora.com/api-docs/#/ |
| XMPP WebSocket | wss://xmpp.chat.ethora.com:5443/ws |
| XMPP host | xmpp.chat.ethora.com |
| XMPP MUC (conference) | conference.xmpp.chat.ethora.com |
| Web app (sign up, admin) | https://app.chat.ethora.com |
What you can build
- Chat / Messaging — 1:1 and group chat, push notifications, audio/video calls
- AI Assistants — LLM-powered bots, RAG pipelines, prompt engineering
- Backend-as-a-Service — Users, files, push notifications out of the box
- Digital Wallets — ERC-20/721/1155 tokens, documents, digital assets
- Gamification — Coins/points, referrals, daily bonuses, collectibles
Architecture
Your App
└── Ethora SDK (React.js / React Native / Android / Swift / WordPress)
└── Ethora Platform API (REST + XMPP)
├── Chat (Ejabberd + custom services)
├── AI (LLM bots, RAG)
├── Users & Auth (SSO, JWT)
├── Files & Storage (S3/IPFS)
├── Push Notifications (FCM/APNs)
└── Blockchain (EVM, optional)
Hosting options: Cloud (free tier) | Self-hosted (AWS Marketplace / Docker) | Ded