> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-docs-event-stream-action-templates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Universal Components for iOS Applications

> Learn how to install and configure Auth0 Universal Components for iOS 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 iOS](https://github.com/auth0/ui-components-ios) SDK provides pre-built, embeddable UI for Auth0 identity flows using [SwiftUI](https://developer.apple.com/swiftui).

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

## Prerequisites

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

* Operating systems: **iOS 16.0+**
* Programming language: **Swift 5+** (6 preferred), **Xcode 16+** (26+ preferred)

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

## Install the SDK

The Universal Components for iOS SDK is distributed as the `Auth0UniversalComponents` package through [Swift Package Manager](https://swift.org/package-manager/) and [Carthage](https://github.com/Carthage/Carthage).

### Swift Package Manager

Auth0 recommends using the Swift Package Manager to install the SDK:

1. Open [**Xcode**](https://developer.apple.com/documentation/xcode).

2. Select **File > Add Package Dependencies**.

3. Add the following repository URL:

   ```text theme={null}
   https://github.com/auth0/ui-components-ios.git
   ```

4. Select version `1.0.0-beta.0` or later.

5. Add `Auth0UniversalComponents` to your application target.

### Carthage

If you use the [Carthage](https://github.com/Carthage/Carthage) dependency manager:

1. Add the following to your Cartfile:

   ```text theme={null}
   github "auth0/ui-components-ios" ~> 1.0.0
   ```

2. Run the following command:

   ```bash theme={null}
   carthage bootstrap --platform iOS --use-xcframeworks
   ```

### Verify the SDK installation

To verify the Universal Components for iOS SDK installation, import the `Auth0UniversalComponents` module in a Swift file to confirm that the framework resolves:

```swift wrap lines theme={null}
import Auth0UniversalComponents
```

## Sample application

You can review the Universal Components for iOS sample application [`AppUIComponents`](https://github.com/auth0/ui-components-ios/tree/main/AppUIComponents) on GitHub.

The sample application includes `AppUIComponentsApp.swift` that serves as the main SwiftUI entry point for SDK initialization and `ThemeManager.swift` that handles custom theme injection and runtime switching.

## Next steps

<CardGroup cols={2}>
  <Card title="Customize style and themes" icon="palette" href="/docs/get-started/universal-components/ios/ios-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/ios/components/my-account-overview">
    Prepare your Auth0 tenant, initialize the SDK, and render the authentication-methods management UI.
  </Card>
</CardGroup>