Ethora SDK

April 22, 2026 · View on GitHub

Legend

TagMeaning
NewBrand new feature or component
ImprovedEnhancement to existing functionality
FixedBug fix
RestoredPreviously available feature brought back
RefactoredCode restructuring (no user-facing change)
DocsDocumentation updates
TestingTest coverage additions
APIBackend/API-facing change
MilestoneVersion or release landmark

Week 17 (Apr 16–22, 2026)

Android SDK (sdk-android)

ethora-sdk-android | CHANGELOG

Major feature release (Apr 21):

  • New: URL link previews in messages — new UrlPreviewStore renders link cards inline (2de87c6)
  • New: Connection state monitoring — ConnectionStore + ConnectionHook expose live connection status to host apps
  • New: Event dispatcher — ChatEvents + ChatEventDispatcher let host apps subscribe to chat lifecycle events
  • Docs: Feature documentation + Android ↔ iOS platform comparison + restructured README (35909da)
  • Refactored: Sample app extracted into ethora-sample-android — SDK repo no longer tracks sample-chat-app/ (86fd0a2)
  • Fixed: Message loader + XMPP websocket edge cases, ChatRoomView rendering (9998279)

iOS SDK (sdk-swift)

ethora-sdk-swift | CHANGELOG

  • New: UnreadStateBridge hook for badge propagation to host apps (83208b9)
  • Testing: UnreadStateBridgeTests added (83208b9)
  • Docs: Full README + INSTALLATION overhaul, new features.md (0e1605f)
  • Refactored: API surface alignment across AppConfig, AuthAPI, RoomsAPI, XMPPClient, MessageParser, ChatRoomViewModel, RoomListView (146c52f)
  • Refactored: Examples/ folder removed — playground moving to dedicated sample repo (97d54f9)

Sample Android (sample-android)

ethora-sample-android | CHANGELOG

  • Refactored: Package namespace com.ethora.sample → com.ethora.samplechatapp (74d0521)
  • New: Firebase push notifications wired — EthoraApplication, EthoraFirebaseMessagingService, AndroidManifest entries
  • New: MainActivity rewritten as full playground-style sample (881 lines)
  • API: buildConfigField schema updated — added ETHORA_USER_JWT + ETHORA_ROOM_JID, removed ETHORA_APP_TOKEN

Setup CLI (@ethora/setup) — v26.04

ethora-setup | CHANGELOG

  • Improved: Server presets switched to canonical chat.ethora.com defaults (Cloud Production + Cloud QA) (5c83f05)
  • Fixed: MainActivity.kt patcher generalised to accept any host — was silently no-op'ing after SDK templates moved off ethoradev.com (35d47ef)

Week 15–16 (Apr 2–15, 2026)

iOS SDK (sdk-swift)

  • New: SDK playground (Examples/SDKPlayground/) — Setup / Chat / Logs tabs for exercising SDK features (53a8839, c4ac7d0)
  • New: Single-chat mode — ChatWrapperView + UseChatWrapperInit hook (7122809)
  • Fixed: Push notifications rewrite completed — new PushNotificationManager, PushSubscriptionService, PendingNotificationJidStore, WalletUsername utility (0b44384)
  • Refactored: XMPPClient+Connection/Handlers/Pings/Stream.swift and ChatRoomViewModel+Actions/History/Messages/Observers/XMPP.swift partials consolidated into single files
  • Improved: MessageLoaderQueue reliability (0150fb2)

Android SDK (sdk-android)

  • New: SDK playground in sample-chat-app — interactive MainActivity exercising SDK features (fd539c8)
  • Improved: XMPPClient hardened (213-line update), XMPPSettings extended, IncrementalHistoryLoader / MessageLoader reliability (97ad445)
  • Docs: Push notification setup instructions added to README; google-services.json no longer committed — developers supply their own Firebase config (670c337)

Week 13–14 (Mar 19 – Apr 1, 2026)

Android SDK (sdk-android)

  • New: Firebase push notifications wired through sample app — new EthoraApplication, EthoraFirebaseMessagingService, AndroidManifest entries (925b9d8)
  • Improved: PushAPI + PushNotificationManager updated for new registration flow

iOS SDK (sdk-swift)

  • New: sendGlobalPresence operation (d15067b)
  • Fixed: XMPP nickname handling (16eacdf)
  • Fixed: View polish batch — message rendering, footer button, open-chat view, scroll, image viewing (64548b1, 0f3c2eb, 9d79d67, 6bd509e, b1b9488)
  • Improved: Debug logging + docs / example app updates (a874a22)

Sample Android (sample-android)

  • New: Initial sample app — Ethora Android SDK quickstart (b6773fc)
  • New: Monthly release workflow publishing vYY.MM tags (e993c24)

Setup CLI (@ethora/setup)

  • New: React.js SDK support — patches config.ts directly when a React.js clone is detected (instead of writing a separate .env.ethora) (a912550)

Week 12–13 (Mar 10–18, 2026)

Android SDK (sdk-android) — v1.0.0

ethora-sdk-android | v1.0.0 | Now available via JitPack

Major release addressing all reported issues and adding key features:

  • New: JitPack distribution — install via Gradle dependency instead of manual zip/git (68f708f)
  • New: Unread message badge support for chat rooms
  • New: Single-room mode — set roomJid in EthoraChatConfig to lock the SDK to one conversation
  • New: JWT token fields — set user JWT directly so the chat component handles all data fetching internally
  • Improved: Renamed devServer to xmppServer in config to avoid confusion in production deployments
  • Improved: Removed confusing ethora-cc-android nested module — single clean repo structure with unified documentation
  • Improved: Better error handlers and improved first-load performance
  • Fixed: /chats/my returning 401 when using email login — resolved by allowing direct JWT token injection
  • Fixed: (+) button crash (PlatformRipple exception) when disableHeader: true — button now hidden cleanly with option to add custom UI
  • Docs: Consolidated to single documentation file, resolving README vs INSTRUCTIONS discrepancy

API / Backend

  • Fixed: POST /v1/apps returning 422 — updated auth middleware to correctly handle ACL
  • Fixed: GET /v2/chats/users — limit and offset query parameters now work correctly; getChatUserById no longer returns multiple users
  • Improved: Broadcast API and admin UI for enterprise mass messaging

Setup CLI (@ethora/setup) — NEW

ethora-setup

New interactive CLI tool for developer onboarding — register, create apps, and generate SDK config files without leaving the terminal.

  • New: npx @ethora/setup — full onboarding flow: account registration, app creation, credential generation (2c7c89a)
  • New: Server presets — Cloud QA (latest) and Cloud Production (ethora.com) (97731f3)
  • New: SDK clone + auto-config — setup can clone the target SDK repo and write config directly into it (f86a6d1)
  • New: Android SDK patching — automatically patches AppConfig.kt and MainActivity.kt with your credentials (f2ca5fe)
  • API: Switched to v2 signup/login routes (password set directly, no email confirmation step) (963bc59)

Web App (app-reactjs)

ethora-app-reactjs dev branch

  • Restored: Chat broadcast tools in admin app settings panel (ab5ab2c)
  • Fixed: Mobile push notification settings and base app UX settings were missing — now restored (05acb37)
  • Testing: Added Playwright smoke test coverage (37af18c)

Playground

ethora-sdk-playground

  • New: Server-side token generation support (f4f7ef6)
  • Improved: Updated chat SDK version (f4f7ef6)
  • Fixed: Server token handling fix (4db67a6)

Monorepo

ethora

  • New: Reorganized as SDK monorepo with 11 git submodules (flat sdk-* / app-* prefix structure)
  • New: Ecosystem navigation table in README linking all SDKs, tools, and sample apps

Week 11 (Mar 3–9, 2026)

Playground

ethora-sdk-playground

  • Fixed: Environment variable loading fix (34bad25)

Backend Integration

ethora-sdk-backend-integration

  • Improved: New logic handling and documentation updates (d6af11b)

Weeks 7–10 (Feb 6 – Mar 2, 2026)

Android SDK (sdk-android)

ethora-sdk-android

  • New: Push notifications support (da0cac6)
  • New: Media sending — users can now send images and files in chat (72a0b2a)
  • New: Media viewing — inline image/file preview in messages (afa30e1)
  • New: Message animation effects (fa75cf9)
  • Improved: Code split for better modularity (da0cac6)
  • Improved: Pagination loader — fixed infinite scroll and "load more" behavior (4f67d27)
  • Fixed: Message animation rendering issues (2485565)
  • Milestone: Versions v0.7 → v0.8 → v0.9.1 → v1.0 progression (87066f7...f555462)

iOS SDK (sdk-swift)

ethora-sdk-swift

  • New: Push notifications support, code split (8b20dcd)

Playground

ethora-sdk-playground

  • New: Direct HTTP API testing panel for debugging and exploring endpoints (dab8ee9)
  • New: Chat metadata update via direct HTTP request (fa71264)
  • New: Integration guide (b13f812)
  • Refactored: SDK type definitions — new ChatRepository interface, aligned with API request/response structures (9d75900)