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

# iOS Setup

> iOS Setup — Zixflow React Native SDK integration guide.

### CocoaPods Integration

The Zixflow React Native SDK automatically integrates with the native iOS SDK via CocoaPods or Swift Package Manager. If you're using **React Native 0.60 or higher**, dependencies are auto-linked.

1. **Navigate to the iOS directory**:

```bash theme={null}
cd ios
```

2. **Install CocoaPods dependencies**:

```bash theme={null}
pod install
```

3. **Open the workspace in Xcode**:

```bash theme={null}
open YourApp.xcworkspace
```

The SDK will automatically include the necessary Zixflow iOS modules:

* `ZixflowCommon`
* `ZixflowDataPipelines`
* `ZixflowMessagingPush`
* `ZixflowMessagingPushAPN` (for APNs)
* `ZixflowMessagingInApp`

### Swift Package Manager Integration

If you prefer **Swift Package Manager (SPM)**, you can configure your project to use the Zixflow iOS SDK directly:

1. **Open your project in Xcode**
2. **Go to File > Add Package Dependencies**
3. **Enter the repository URL**:
   ```
   https://github.com/zixflow/zixflow-ios.git
   ```
4. **Select the version**: Use `1.0.0` or higher
5. **Add the following modules** to your app target:
   * `Zixflow` (umbrella module)
   * `ZixflowDataPipelines`
   * `ZixflowMessagingPushAPN`
   * `ZixflowMessagingInApp`

> **Note**: The example app uses SPM for the native iOS SDK integration. See `example/ios/Podfile` for reference.

### Push Notification Setup (APNs)

To enable **Apple Push Notifications (APNs)**:

1. **Enable Push Notifications capability** in Xcode:
   * Select your app target
   * Go to **Signing & Capabilities**
   * Click **+ Capability** and add **Push Notifications**

2. **Enable Background Modes**:
   * Add **Background Modes** capability
   * Enable **Remote notifications**

3. **Configure APNs certificates** in your Apple Developer account and upload them to Zixflow dashboard.

### Notification Service Extension

To support **rich push notifications** (images, videos, action buttons), you need to add a **Notification Service Extension**:

1. **Create a Notification Service Extension** in Xcode:
   * File > New > Target > Notification Service Extension
   * Name it `NotificationServiceExtension`

2. **Add Zixflow modules to the extension** in your `Podfile`:

```ruby theme={null}
target 'NotificationServiceExtension' do
  pod "ZixflowMessagingPushAPN", "~> 1.0"
  pod "ZixflowMessagingPush", "~> 1.0"
  pod "ZixflowDataPipelines", "~> 1.0"
  pod "ZixflowCommon", "~> 1.0"
  pod "AnalyticsSwiftZixflow", "1.7.3+zixflow.1"
end
```

3. **Update `NotificationService.swift`**:

```swift theme={null}
import UserNotifications
import ZixflowMessagingPushAPN

class NotificationService: UNNotificationServiceExtension {
    var contentHandler: ((UNNotificationContent) -> Void)?
    var bestAttemptContent: UNMutableNotificationContent?

    override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        self.contentHandler = contentHandler
        bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)

        // Use Zixflow to handle rich push
        MessagingPushAPN.didReceive(request, withContentHandler: contentHandler)
    }

    override func serviceExtensionTimeWillExpire() {
        if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
            contentHandler(bestAttemptContent)
        }
    }
}
```

4. **Run `pod install`** again to install extension dependencies.

***