https://github.com/dappros/ethora-sample-android
Sample Android chat app using Ethora SDK — clone, configure, run
https://github.com/dappros/ethora-sample-android
Last synced: about 1 month ago
JSON representation
Sample Android chat app using Ethora SDK — clone, configure, run
- Host: GitHub
- URL: https://github.com/dappros/ethora-sample-android
- Owner: dappros
- Created: 2026-03-20T13:14:54.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-22T16:03:21.000Z (about 2 months ago)
- Last Synced: 2026-04-22T17:36:12.760Z (about 2 months ago)
- Language: Kotlin
- Size: 71.3 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ethora Sample Android App
A minimal Android chat app demonstrating the [Ethora SDK](https://github.com/dappros/ethora-sdk-android). Open in Android Studio, configure, and run.
## Quick Start
### Option A: Automatic setup (recommended)
```bash
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](https://ethora.com) and create an app
2. Edit `app/build.gradle.kts` — replace the `CHANGE_ME` values with your credentials:
```kotlin
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`).
3. 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)
## Links
- [Ethora SDK documentation](https://github.com/dappros/ethora-sdk-android)
- [Ethora monorepo](https://github.com/dappros/ethora) — all SDKs (Android, iOS, React, WordPress)
- [Setup tool](https://github.com/dappros/ethora-setup) — CLI for account + credential management