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)
To enable Auth0 passkey support, you need iOS 16.6+.
Install the SDK
The Universal Components for iOS SDK is distributed as theAuth0UniversalComponents package through Swift Package Manager and Carthage.
Swift Package Manager
Auth0 recommends using the Swift Package Manager to install the SDK:- Open Xcode.
- Select File > Add Package Dependencies.
-
Add the following repository URL:
-
Select version
1.0.0-beta.0or later. -
Add
Auth0UniversalComponentsto your application target.
Carthage
If you use the Carthage dependency manager:-
Add the following to your Cartfile:
-
Run the following command:
Verify the SDK installation
To verify the Universal Components for iOS SDK installation, import theAuth0UniversalComponents module in a Swift file to confirm that the framework resolves:
Sample application
You can review the Universal Components for iOS sample applicationAppUIComponents 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
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 authentication-methods management UI.