# Build and Run LlmBench on Android

> Open the LlmBench Kotlin Multiplatform project in Android Studio and build its Android app with the repository's current Java and SDK requirements.

LlmBench is a Kotlin Multiplatform workspace with Android as the first shipping client. The Android app has `minSdk 26`, `targetSdk 35`, and currently compiles against API 37 with Java 21.

<Steps>
  <Step title="Clone the repository">
    ```bash
    git clone https://github.com/twojstar/llmbench.git
    cd llmbench
    ```
  </Step>
  <Step title="Open in Android Studio">
    Open the repository root in a current Android Studio release and let Gradle import the `:app` and `:shared` modules.
  </Step>
  <Step title="Sync Gradle">
    Install Android SDK Platform 37 if Android Studio asks for the compile SDK, then sync the project with JDK 21 selected for Gradle.
  </Step>
  <Step title="Build the Android app">
    ```bash
    ./gradlew :app:assembleDebug
    ```

    On Windows PowerShell or Command Prompt, use `gradlew.bat :app:assembleDebug`.
  </Step>
  <Step title="Run on a device or emulator">
    Connect a device running Android 8.0 / API 26 or newer, or start a compatible emulator, then run the `app` configuration from Android Studio.
  </Step>
</Steps>

<Note>
  The UI remains Compose-first. Shared code lives in the Kotlin Multiplatform `shared` module, while Android keeps platform-native WebView, upload, authentication, and secure-storage behavior where needed.
</Note>

## Prerequisites

- A current stable Android Studio
- JDK 21
- Android SDK Platform 37
- An Android device or emulator on API 26 or newer

## Verify your build

A successful debug build creates the APK under the `app` module's build outputs. Running it should open LlmBench with its account-backed provider tabs and native chat/compare surfaces.