> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS (Swift)

> Present Dojah's verification flow in an iOS app with the Dojah Swift SDK, added through Swift Package Manager.

Present Dojah’s verification flow in an iOS app with the Dojah Swift SDK, added via Swift Package Manager.

<Note>
  Mobile SDKs launch by **WidgetID** (from [EasyOnboard](/dashboard-guide/workflows/easyonboard)). See [Choosing an SDK](/api-reference/widget-sdks/choosing-an-sdk).
</Note>

## Install

Add the package in Xcode (**File → Add Packages…**) using the repository URL, on the `main` branch:

```swift Swift Package Manager theme={null}
https://github.com/dojah-inc/sdk-swift.git
```

Add the usage descriptions your flow needs to `Info.plist`: `NSCameraUsageDescription`, `NSMicrophoneUsageDescription` (video), and `NSLocationWhenInUseUsageDescription` (location).

## Initialize

Call `DojahWidgetSDK.initialize` with your WidgetID and a `UINavigationController` to present on:

```swift ViewController.swift theme={null}
DojahWidgetSDK.initialize(
    widgetID: "your_widget_id",        // required
    referenceID: "DJ-123456",           // optional
    emailAddress: "user@email.com",      // optional
    navController: navigationController // required
)
```

## CocoaPods

If your project uses CocoaPods rather than Swift Package Manager — which is how the React Native and Flutter SDKs pull iOS in — add the pod from the `pod-package` branch:

```ruby Podfile theme={null}
pod 'Realm', '~> 10.52.2', :modular_headers => true
pod 'DojahWidget', :git => 'https://github.com/dojah-inc/sdk-swift.git', :branch => 'pod-package'
```

## Resources

* [GitHub — dojah-inc/sdk-swift](https://github.com/dojah-inc/sdk-swift) (SDK and example app)
* [Releases and changelog](https://github.com/dojah-inc/sdk-swift/releases) — check here before pinning a version
* [Choosing an SDK](/api-reference/widget-sdks/choosing-an-sdk) · [EasyOnboard](/dashboard-guide/workflows/easyonboard)