> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ownid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Android SDK setup

> Install and initialize the OwnID Android SDK, choose Core or Compose, and prepare your app for native passkeys.

Use the OwnID Android SDK to add passkey-first authentication and passkey enrollment to a native Android app. Your app remains responsible for user records, sessions, and identity-provider integration.

## Requirements

* Android API 23+
* Compile SDK 35+
* Core Kotlin compatibility baseline: 1.8.22
* Compose UI Kotlin compatibility baseline: 1.9.25
* Jetpack Compose 1.7.8+ for Compose UI

<Note>
  The SDK supports Android API 23 and later, but Credential Manager passkeys require Android 9 (API 28) or later.
</Note>

## Choose an SDK artifact

<div style={{ display: "flex", gap: "8px", flexWrap: "wrap", alignItems: "center" }}>
  <a href="https://central.sonatype.com/artifact/com.ownid.android-sdk/core" style={{ borderBottom: "none", display: "inline-flex", lineHeight: 0 }}>
    <span className="sr-only">Latest Core Android SDK version</span>

    <img src="https://img.shields.io/maven-central/v/com.ownid.android-sdk/core?label=Latest%20Core%20Android%20SDK" alt="Core Android SDK version badge" aria-hidden="true" style={{ margin: 0 }} />
  </a>

  <a href="https://central.sonatype.com/artifact/com.ownid.android-sdk/compose" style={{ borderBottom: "none", display: "inline-flex", lineHeight: 0 }}>
    <span className="sr-only">Latest Compose Android SDK version</span>

    <img src="https://img.shields.io/maven-central/v/com.ownid.android-sdk/compose?label=Latest%20Compose%20Android%20SDK" alt="Compose Android SDK version badge" aria-hidden="true" style={{ margin: 0 }} />
  </a>
</div>

| Artifact                        | Use it for                                                                                     |
| ------------------------------- | ---------------------------------------------------------------------------------------------- |
| `com.ownid.android-sdk:core`    | SDK configuration, Elite flow, Headless, Passkey Enrollment, WebBridge, and passkey operations |
| `com.ownid.android-sdk:compose` | Boost flow widgets and SDK-provided Compose UI; includes Core transitively                     |

<Tabs>
  <Tab title="Core">
    ```kotlin theme={null}
    dependencies {
        implementation("com.ownid.android-sdk:core:<latest-version>")
    }
    ```
  </Tab>

  <Tab title="Compose UI">
    ```kotlin theme={null}
    dependencies {
        implementation("com.ownid.android-sdk:compose:<latest-version>")
    }
    ```

    The Compose artifact already includes Core. Add Core separately only if you need to pin its version.
  </Tab>
</Tabs>

## Initialize OwnID

Copy the application ID from the OwnID Console and initialize the SDK once during app startup.

```kotlin theme={null}
import android.app.Application
import com.ownid.sdk.OwnId

class App : Application() {
    override fun onCreate() {
        super.onCreate()

        OwnId.initialize {
            applicationContext = this@App.applicationContext
            appId = "<OWNID_APP_ID>"
        }
    }
}
```

Besides the Android application context, `appId` is the only required OwnID setting. For optional settings and alternative initialization methods, see the [full configuration guide](https://github.com/OwnID/ownid-android-sdk/blob/master/docs/setup/configuration.md).

## Enable passkeys

<Card title="Complete passkey setup" icon="key" href="/mobile-sdks/setup/passkeys" horizontal>
  Configure Credential Manager and associate your Android app with the relying party domain before starting a passkey flow.
</Card>

## Choose an integration

<Columns cols={3}>
  <Card title="Boost flow" icon="bolt" href="/mobile-sdks/boost">
    Add OwnID widgets to an existing native login or registration screen.
  </Card>

  <Card title="Elite flow" icon="sparkles" href="/mobile-sdks/elite">
    Run the OwnID-hosted authentication experience in an SDK-managed WebView.
  </Card>

  <Card title="Passkey enrollment" icon="user-plus" href="/mobile-sdks/passkey-enrollment">
    Add a passkey for a user who is already signed in.
  </Card>
</Columns>

## Continue with the Android guides

<Columns cols={2}>
  <Card title="Android documentation" icon="github" iconType="brands" href="https://github.com/OwnID/ownid-android-sdk/blob/master/docs/README.md">
    Explore configuration, providers, flows, customization, examples, and troubleshooting.
  </Card>

  <Card title="Migrate from v3 to v4" icon="arrow-up-right-dots" href="https://github.com/OwnID/ownid-android-sdk/blob/master/docs/upgrade/v3-to-v4.md">
    Update an existing Android SDK version 3 integration.
  </Card>
</Columns>
