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-cli	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	docs.ethora.com	Developer documentation portal.
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) | Dedicated server

Testing & Quality

Each SDK ships with its own automated test suite, all coordinated by a single cross-platform selector contract: Android Compose testTag strings, iOS SwiftUI accessibilityIdentifier strings, and Web data-testid attributes all use the same human-readable IDs (chat_input, chat_send_button, rooms_list, …). Renaming any selector is a four-repo change by design — a contract drift breaks four CI runs the same week instead of silently rotting in one.

Test layers

Layer	Where	What it catches
L1 — Hermetic unit	JVM / Swift unit test, fakes for backend	Pure logic: reducers, parsers, state machines, formatters
L2 — Component UI	Compose UI / SwiftUI snapshot / Vitest + RTL	Single-component rendering + interaction
L3 — E2E synthetic	Maestro (mobile) / Playwright (web) against a real backend	Multi-screen flows, real network, cross-platform parity
L4 — Manual	Tester on a real device	UX feel, IME quirks, real-device-only bugs

General rule: push every test as far down the pyramid as it will go. A pure reducer behaviour that can be expressed at L1 should never live at L2 or L3. L3 is reserved for what L1 + L2 genuinely cannot reach.

Per-SDK testing entry points

SDK	L1 / L2 setup + how to run	L3 flows
Android	`sdk-android/README.md` → Testing — Compose UI test scaffold + JVM unit-test layer, Quickstart commands, AVD setup, full test inventory	`sample-android/.maestro/`
iOS	`sdk-swift/README.md` — XCTest scaffold + `accessibilityIdentifier` markers	`sample-swift/.maestro/`
Web (chat component)	`sdk-reactjs/README.md` — Vitest + RTL setup, shared `data-testid` IDs	Playwright suite in the `ethora-app-reactjs` repo
React Native	`sdk-reactnative/README.md`	(in progress)

Cross-platform scenario catalog

For the failure-mode clusters distilled from field reports and the recommended test layer per cluster, see QA_SCENARIOS.md. The catalog covers 12 areas (multi-room state machine, send + media orchestration, connection lifecycle, send-status correctness, unread counter, history + render parity, media upload, configuration safety, UI affordances, app lifecycle, auth + token state, cross-platform parity) and is updated when a new field bug class doesn't fit cleanly into the existing clusters.

Contributing

We welcome issues, discussions, and PRs across the ecosystem. Each submodule has its own issue tracker — use the relevant repository for bug reports and feature requests.

Open an issue for cross-cutting concerns
Use Discussions for Q&A
Follow conventional commit messages

Contact

Website: https://ethora.com/
Try Free: https://app.chat.ethora.com/register
Twitter/X: https://x.com/EthoraOfficial
LinkedIn: https://www.linkedin.com/company/ethora-official/

License

AGPL and MIT licenses. Commercial licenses available from Dappros.

Previous README content (archive)

Project Updates (Archive)

4 Dec 2024 — New platform UI released

Finally our new version of the overall platform UI is released. This affects the whole web version including chat component and Admin Screens. We hope you like the new look of Ethora and this inspires you to build your fascinating projects with Ethora engine! Both old and new UI are going to remain available for you to use for a few months after which we will sunset the old version. More details in our Community Forum: https://forum.ethora.com/topic/38-new-version-soft-launch/#comment-48

11 Oct 2024 — NPM: Ethora Chat Component

We released the Ethora Chat Component npm package — launch a chat room in minutes without digging into a mono-repo. https://www.npmjs.com/package/@ethora/chat-component

3 Sep 2024 — Web version redesign

We're updating our web design — new login/sign-in screens and Admin dashboard. Follow updates: https://forum.ethora.com/forum/16-updates-and-announcements/

5 Jul 2024 — Chat Component alpha

Alpha of the chat component released. It combines Ethora's platform features with simple embedding. More: https://forum.ethora.com/topic/9-ethora-nmp-package-chat-component-alpha-version/#comment-9

11 Oct 2023 — Architecture & design plans

Architecture review & refactoring; forthcoming design updates (mobile first, then web). Video by @CodeEater21 on building iOS/Android with Ethora: https://www.youtube.com/watch?v=pKEMcxJb5HM Self-hosted options via AWS Marketplace / Docker Hub planned.

Screenshots

React Native — Standard UI (new design)

React Native — Standard UI (old version)

Branded (customized) UI

App Builder

The fastest way to get your app running:

Customize name, logo, colors
Launch your web app on your subdomain
Generate React Native codebases for iOS & Android

Sign up: https://app.chat.ethora.com/register

5-minute demo (widget)

Add an AI chat to any site:

Chat Bots

Ethora uses XMPP for chat. Connect bots in Python, Node.js, etc.

ChatGPT bot — integrate OpenAI/LLMs for topic-specialized assistants
Translate bot — interpreter bot (EN-ES)

Gamification, Referrals & Rewards

Coin (ERC-20) for project economy
Sign-up bonus (100 Coins by default)
Daily check-in (5 Coins)
Referrals (25 Coins to both users)

Threads

Keep busy chats tidy with thread replies.

Core Features

iOS, Android, Web
Your own name, branding, token/coin name
SSO (Social Sign On) via Gmail, Facebook, Apple or email
AI Bots with LLM, RAG, prompt engineering features
Each user gets a digital assets wallet + cryptographic keypair
Coins (ERC-20) & NFTs (ERC-721/1155)
Crypto-likes (tip tokens to messages)
Rooms & spaces, QR/public-key invites
Profiles, push, audio/video calls

Authors & Governance

Ethora & its server infrastructure have been developed since 2018 by Dappros and DeepX. The team is led by Taras Filatov, a Ukrainian-born and UK-based tech entrepreneur.

Backend: Dappros Platform API & DeepX RTC: EVM chain + API/cache (Node.js, Kafka, Redis, MongoDB), IPFS/S3 storage, and XMPP Ejabberd messaging with custom services (Erlang, Mnesia, MySQL, Cassandra).

Commercial model:

Client-side: free, open-source (closed-source commercial license available)
Server-side: freemium (generous free tier + paid SLA for businesses)