> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Setup
> Step-by-step guide for integrating the Para Swift SDK into your iOS application
export const DemoCallout = ({variant = "card", title = "Interactive Demo", description = "Try the live demo to explore authentication flows and customize your modal before integrating."}) => {
if (variant === "subtle") {
return
;
};
export const Link = ({href, label, newTab = false}) => {
const [isHovered, setIsHovered] = useState(false);
return setIsHovered(true)} onMouseLeave={() => setIsHovered(false)}>
{label}
;
};
The Para Swift SDK enables you to integrate secure wallet features including creation, passkey-based authentication, and transaction signing into your iOS applications. This guide covers all necessary steps from installation to implementing authentication flows.
## Prerequisites
To use Para, you need an API key. This key authenticates your requests to Para services and is essential for
integration.
Don't have an API key yet? Request access to the to create API keys, manage billing, teams, and more.
## Install the SDK
1. In your Xcode project, go to **File > Add Packages** or (in your target) **Frameworks, Libraries, and Embedded Content** and click **+**.
2. Enter `https://github.com/getpara/swift-sdk`
3. Select **Up to Next Major Version** and enter `3.0.0`
4. Add the package to your app target and click **Add Package**.
The Para Swift SDK automatically includes the following dependencies:
* **BigInt**: For handling large numbers in blockchain operations
* **PhoneNumberKit**: For phone number validation and formatting
These dependencies will be automatically resolved by Swift Package Manager.
To enable passkeys on iOS, you need to configure Associated Domains:
1. In Xcode, go to **Signing & Capabilities** for your app target
2. Click **+ Capability** and add **Associated Domains**
3. Add the following entries:
```
webcredentials:app.usecapsule.com
webcredentials:app.beta.usecapsule.com
```
4. Register your Team ID + Bundle ID with Para via the
Without properly registering your Team ID and Bundle ID with Para, passkey authentication flows will fail. Contact Para support if you encounter issues with passkey registration.
Heading to App Review? Check for Sign in with Apple, reviewer, and deletion tips.
## Configure URL Scheme
Before initializing Para, you need to configure your app's URL scheme for deep linking. This is required for the `appScheme` parameter and enables OAuth authentication flows.
1. In Xcode, select your project in the navigator
2. Select your app target
3. Go to the **Info** tab
4. Scroll down to **URL Types** and click **+** to add a new URL type
5. Fill in the fields:
* **URL Schemes**: Enter your scheme name (e.g., `paraswift`, `yourapp`)
* **Role**: Select **Editor**
## Initialize Para
To use Para's features, you'll need to initialize a Para manager that can be accessed throughout your app. This manager handles all interactions with Para's services, including authentication, wallet management, and transaction signing.
Below is an example of initializing the SDK in a SwiftUI application:
```swift App.swift theme={null}
import SwiftUI
import ParaSwift
@main
struct ExampleApp: App {
@StateObject private var paraManager: ParaManager
init() {
// Initialize Para manager
_paraManager = StateObject(wrappedValue: ParaManager(
environment: .beta, // Use .prod for production
apiKey: "YOUR_API_KEY_HERE", // Get from: https://developer.getpara.com
appScheme: "yourapp" // Your app's URL scheme for deep linking
))
}
var body: some Scene {
WindowGroup {
ContentView()
.environmentObject(paraManager)
}
}
}
```
The `appScheme` parameter must match the URL scheme you configured in your Info.plist. This enables deep linking for external wallet integrations like MetaMask and OAuth authentication flows.
## Continue with Authentication
Once Para is initialized, implement your auth experience using the Authentication & Users guides:
*
*
For wallet creation and transaction signing examples, jump into the blockchain guides:
*
*
*
*
## Example
For a complete implementation example, check out our Swift SDK example app:
## Next Steps
After setup, use these guides for authentication and wallet signing flows.