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

npx @ethora/setup

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

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_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\"")

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

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

• 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)

• Ethora SDK documentation
• Ethora monorepo — all SDKs (Android, iOS, React, WordPress)
• Setup tool — CLI for account + credential management