# United CHAT for Android — source code (version 0.3.0, versionCode 1005)

United CHAT for Android is a modified version of **SimpleX Chat** (https://github.com/simplex-chat/simplex-chat),
licensed under the **GNU Affero General Public License v3.0** (see `LICENSE`). This archive is the complete
Corresponding Source of the United CHAT Android app published on Google Play (package `app.united.chat`).

- Upstream base: SimpleX Chat **v7.0.2** (`stable` branch, commit `4df04bd`).
- Our changes (branding, colours, onboarding texts, Polish translations, release signing setup, notification icons, target SDK 36, iOS-like theme) are in the commits on
  top of that base; the same changes are provided separately as `united-chat-android-0.3.0.patch`.
- Copyright of the original work: SimpleX Chat Ltd and contributors. Modifications © 2026 UnitedAI.

## Build (macOS or Linux)
Requirements: JDK 17, Android SDK (platform 35), NDK `23.1.7779620`, CMake 3.22.1.

1. Native core: `libsimplex.so` and `libsupport.so` are built from the Haskell core in this repository
   (`src/`, `cabal.project`, see upstream docs `docs/CONTRIBUTING.md` / `scripts/android`). For convenience,
   `scripts/get_core_libs.sh v7.0.2` extracts the identical prebuilt libraries from the official SimpleX Chat v7.0.2 APKs
   published by SimpleX on GitHub.
2. In `apps/multiplatform/local.properties` set `sdk.dir=<path to Android SDK>`.
3. `cd apps/multiplatform && ./gradlew :android:bundleGoogleRelease` (Play bundle) or `./gradlew :android:assembleFossRelease` (APKs).

The Google Play upload key is not part of the source (by design). Without
`../../../android-keystore/keystore.properties` the release build is produced unsigned; sign it with your own key.

Contact: office@unitedai.app · https://chat.unitedai.app
