> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-ips-6621-xaa-idp-revamp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Universal Components for Android Applications

> Learn how to install and configure Auth0 Universal Components for Android applications.

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "Early Access"
  };
  const stageText = stageTextMap[stage] || "a product release stage";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>This feature is available for {linkify(`${plans} plans`, "https://auth0.com/pricing")}. </>}
            {contact && "To participate, contact " + contact + ". "}
            {terms && <>By using this feature, you agree to the applicable Free Trial terms in Okta's {linkify("Master Subscription Agreement", "https://www.okta.com/legal")}.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>The {feature} feature is in {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Auth0 Universal Components" stage="beta" terms="true" contact="Auth0 Support" />

The Auth0 [Universal Components for Android](https://github.com/auth0/ui-components-android) SDK provides pre-built, embeddable UI for Auth0 identity flows using [Jetpack Compose](https://developer.android.com/compose).

Universal Components for Android are built on top of the [Auth0 Android SDK](https://github.com/auth0/Auth0.Android) and integrate with [My Account APIs](/docs/manage-users/my-account-api).

## Prerequisites

To configure the Universal Components for Android SDK, you need:

* Operating systems: **Android 11+** (API 30).
* Programming language: **Kotlin 2.2+**, **Android Gradle Plugin 8.11+**, **Jetpack Compose BOM 2024.09.00+**, **JDK 17+**.

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  To enable Auth0 [passkey](/docs/authenticate/database-connections/passkeys) support, you need **Android 14+**.
</Callout>

## Install the SDK

The Universal Components for Android SDK is distributed as the `com.auth0.universalcomponents:universal-components` package through the [Maven Central](https://mvnrepository.com/artifact/com.auth0) repository.

### Gradle

Use Gradle to install the SDK:

1. Add the `mavenCentral()` repository if it is not listed in your `settings.gradle` or `settings.gradle.kts` file:

   ```kotlin theme={null}
   dependencyResolutionManagement {
       repositories {
           mavenCentral()
           google()
       }
   }
   ```

2. Add the dependency to your module-level `build.gradle` or `build.gradle.kts`:

   ```kotlin theme={null}
   dependencies {
       implementation("com.auth0.universalcomponents:universal-components:1.0.0-beta.0")
   }
   ```

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  Auth0 recommends using [Auth0.Android v3+](https://github.com/auth0/Auth0.Android) in your application. Older versions may cause compilation errors when resolved alongside Universal Components.
</Callout>

### Configure Compose

Ensure [Compose](https://developer.android.com/develop/ui/compose/setup-compose-dependencies-and-compiler#setup-compose-dependencies) is enabled in your application's `build.gradle` file:

```kotlin wrap lines theme={null}
android {
    buildFeatures {
        compose = true
    }
}
```

### Verify the installation

To verify the Universal Components for Android SDK installation, confirm the dependency resolves by running:

```bash wrap lines theme={null}
./gradlew app:dependencies | grep universal-components
```

## Sample application

You can review the sample application of the [Universal Components for Android](https://github.com/auth0/ui-components-android#run-the-sample-app) SDK on GitHub.

The sample application includes `MainActivity.kt` that initializes the SDK using `Auth0UniversalComponents.initialize()` and `LoginSecurityScreen.kt` that renders the `AuthenticatorSettingsComponent`.

## Next steps

<CardGroup cols={2}>
  <Card title="Customize style and themes" icon="palette" href="/docs/get-started/universal-components/android/android-theming">
    Override colors, typography, spacing, radius, and size tokens using the Auth0 design-token system.
  </Card>

  <Card title="Build a Self-Service Account Security Interface" icon="key" href="/docs/get-started/universal-components/android/components/my-account-overview">
    Prepare your Auth0 tenant, initialize the SDK, and render the authentication-methods management UI.
  </Card>
</CardGroup>