Ethora Sample Android App

April 23, 2026 · View on GitHub

A minimal Android chat app demonstrating the Ethora SDK. Open in Android Studio, configure, and run.

Quick Start

npx @ethora/setup

The setup tool creates your Ethora account, provisions test users, and writes config directly into this project.

Option B: Manual setup

  1. Create an account at ethora.com and create an app
  2. Edit app/build.gradle.kts — replace the CHANGE_ME values with your credentials:
buildConfigField("String", "ETHORA_APP_ID", "\"your-app-id\"")
buildConfigField("String", "ETHORA_APP_TOKEN", "\"your-app-token\"")
buildConfigField("String", "ETHORA_USER_JWT", "\"your-user-jwt\"")
buildConfigField("String", "ETHORA_API_BASE_URL", "\"https://api.your-server.com\"")
buildConfigField("String", "ETHORA_XMPP_SERVER_URL", "\"wss://xmpp.your-server.com/ws\"")
buildConfigField("String", "ETHORA_XMPP_HOST", "\"xmpp.your-server.com\"")
buildConfigField("String", "ETHORA_XMPP_CONFERENCE", "\"conference.xmpp.your-server.com\"")

ETHORA_APP_TOKEN is required for Email auth mode (/users/login-with-email). ETHORA_USER_JWT is used by JWT auth mode (/users/client).

  1. Open in Android Studio and run on an emulator (API 26+)

Requirements

  • Android Studio Hedgehog (2023.1) or later
  • JDK 17
  • Android SDK 34
  • Emulator or device running API 26+

What's Inside

  • app/ — Sample app with Material 3 Compose UI, bottom navigation (Home + Chat tabs), unread message badges
  • SDK imported via JitPack: com.github.dappros:ethora-sdk-android:v1.0.19
  • Java 8+ desugaring enabled (required by the SDK)