# NikoGPT for Android

Open-source Android client for the NikoGPT web chat
([chat.n1ko.dev](https://chat.n1ko.dev)) — a thin, auditable WebView shell
around the same web interface that runs in the browser. No analytics, no
trackers, no third-party SDKs: the whole app is one activity and a handful of
resources.

- **Android 10+** (`minSdk 29`), targets Android 15.
- **Everything the web app can do**: conversations, attachments (system file
  picker), images, generated files, settings, themes.
- **Share anything to NikoGPT**: from another app share text or any file
  (photos, PDFs, audio, archives…) straight into the composer.
- **Personal context**: the app can tell the chat where you are (the street
  you are on — never the house number; Android geocodes the position itself)
  and which phone you write from (model and firmware). The place follows you:
  the app keeps the position fresh while it is on screen. Both are optional
  and switched on in **Settings → Context**.
- **Updates itself**: the app checks the published version on launch and
  offers the update right there (download + system installer). The check can
  be turned off in **Settings → App**, or with "don't check again" in the
  dialog.
- Downloads go through Android's `DownloadManager` (with your session
  cookies), links to other sites open in the system browser.
- **Open in the browser only**: `chat.n1ko.dev` loads inside; anything else
  leaves the app.
- TLS errors are never bypassed, no cleartext traffic, no backup.
- Day/night theme follows the system; the page keeps its own theme setting.
- Back gesture navigates the chat history; pull-to-refresh reloads only at
the very top of the chat — never inside a presentation, a dialog or another
list.

## Install

Download the APK from the releases page:
**https://git.n1ko.dev/Niko/nikogpt_android/releases**

Latest build:
https://git.n1ko.dev/Niko/nikogpt_android/releases/download/v1.4.1/nikogpt-android-1.4.1.apk

Open the APK on the phone (allow installing apps from this source when Android
asks). The APKs are signed with the project's release key; Android may still
warn because the app is installed from outside Play.

## Build

Requirements: JDK 17, Android SDK (platform 35, build-tools 35.0.0).

```bash
./gradlew assembleDebug     # app/build/outputs/apk/debug/app-debug.apk
./gradlew assembleRelease   # release; signed with the keystore when configured
```

Or just open the project in Android Studio.

### Release signing

The published APKs are signed with the project's release keystore
(`keystore.properties` + the `.jks` file, both outside git). To build them
yourself, create a keystore and point `keystore.properties` at it:

```bash
keytool -genkeypair -v -keystore nikogpt.jks -alias nikogpt \
  -keyalg RSA -keysize 2048 -validity 10000
cat > keystore.properties <<EOF
storeFile=../nikogpt.jks
storePassword=...
keyAlias=nikogpt
keyPassword=...
EOF
./gradlew assembleRelease
```

**Installing over a debug-signed build requires uninstalling it first** (the
signatures differ). The release certificate's SHA-256 must be listed in
`web.android_cert_sha256` in the bot config for App Links verification.

## Sign-in

All credentials live on NikoAuth (`auth.n1ko.dev`): password, e-mail codes,
2FA and Google. The app opens the login in the system browser — Google
refuses WebView logins, and a WebView never shares the browser's cookie jar —
and comes back through a verified App Link
(`https://chat.n1ko.dev/app-auth?...`) once the login is done; the server
hands the fresh session to the app's WebView on that link. Requires the
release certificate's SHA-256 in the bot's `web.android_cert_sha256` for
App Links verification.

## Structure

| Path | Purpose |
|---|---|
| `app/src/main/java/dev/n1ko/nikogpt/MainActivity.kt` | the whole app: WebView setup, file chooser, downloads, back handling |
| `app/src/main/res/layout/activity_main.xml` | WebView + progress bar + retry screen |
| `.forgejo/workflows/build.yml` | CI: builds the APK on tags |

## License

MIT — see [LICENSE](LICENSE). The Tabler-based icons used by the web chat come
from [f.n1ko.dev/assets/ui](https://f.n1ko.dev/assets/ui) (MIT).