Skip to main content

Documentation Index

Fetch the complete documentation index at: https://auth0-feat-docs-5492.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Auth0 Universal Components for Native Applications ships pre-built, embeddable UI for identity flows using iOS (SwiftUI) and Android (Jetpack Compose).

Prerequisites

To use Auth0 Universal Components for Native Applications: For iOS implementations:
  • Supported OS: iOS 16.0+, macOS 13.0+, visionOS 1.0+.
  • Recommended Language: Swift 5+ (6 Preferred), Xcode 16+.
Auth0 Passkeys support requires iOS 16.6+, macOS 13.5+, or visionOS 1.0+ for Apple platforms, and Android 14+ for Android devices. The base SDK supports Android 11+ (API 30); Passkeys specifically require Android 14+.

Install the SDK

The iOS SDK is distributed as Auth0UniversalComponents. Auth0 recommends using the Swift Package Manager installer.

Swift Package Manager

  1. Use Xcode, select File → Add Package Dependencies and enter:
    https://github.com/auth0/ui-components-ios.git
    
  2. Select version 1.0.0-beta.0 or later, then add Auth0UniversalComponents to your application target.

CocoaPods

  1. Add the pod to your Podfile:
    pod 'Auth0UniversalComponents', '~> 1.0.0'
    
  2. Then run:
    pod install
    
Known issue: The 1.0.0 CocoaPods release omits bundled Media, Colors, and Fonts resources. If your UI renders without the expected styling, use the Swift Package Manager until the next podspec release.

Carthage

  1. Add the following to your Cartfile:
    github "auth0/ui-components-ios" ~> 1.0.0
    
  2. Then run:
    carthage update --use-xcframeworks
    

Verify the installation

Import the module in a Swift file to confirm the framework resolves:
import Auth0UniversalComponents

Sample application

You can review the sample application AppUIComponents target in the ui-components-ios GitHub repo for a reference implementation. It includes AppUIComponentsApp.swift for SDK initialization and Common/ThemeManager.swift for runtime theme switching.
Once the SDK is installed, you can continue to Build a Self-Service Account Security Interface to wire authentication and render the auth-methods management UI.

Next steps

Customize style and themes

Override colors, typography, spacing, radius, and size tokens using the Auth0 design-token system.

Build a Self-Service Account Security Interface

Prepare your Auth0 tenant, initialize the SDK, and render the auth-methods management UI.