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

# Install the SDK

> Add the Encore Swift SDK to your iOS project via Swift Package Manager.

## Overview

The Encore SDK is distributed as a **public Swift Package**. No access token or authentication is required — add it straight from GitHub via Swift Package Manager.

The repository URL is:

```bash theme={null}
https://github.com/EncoreKit/ios-sdk
```

***

## Requirements

| Requirement               | Minimum            |
| ------------------------- | ------------------ |
| **iOS deployment target** | iOS 15.0+          |
| **Xcode**                 | 15.0+ (Swift 5.9+) |

<Note>
  The SDK installs and runs on iOS 15+. The offer sheet UI is built with SwiftUI sheets and renders on **iOS 17+**. On iOS 15–16, calls to `placement(_:).show()` resolve immediately with `NotGrantedReason.unsupportedOS` instead of presenting UI, so your `onPassthrough` handler still runs and the user is never blocked.
</Note>

***

## Install via Swift Package Manager

Swift Package Manager is Apple's official dependency manager, integrated into Xcode.

### Option A — Add in Xcode

<Steps>
  <Step title="Open Add Package Dependencies">
    In **Xcode**, select **File ▸ Add Package Dependencies…**
  </Step>

  <Step title="Paste the repository URL">
    Paste the public repository URL into the search field:

    ```bash theme={null}
    https://github.com/EncoreKit/ios-sdk
    ```

    Press Return — the package resolves automatically.
  </Step>

  <Step title="Set the dependency rule">
    Set **Dependency Rule** to **Up to Next Major Version** with a lower bound of **1.0.0**, then click **Add Package**.
  </Step>

  <Step title="Add to your target">
    Ensure the **Encore** library is added to your app's target, then click **Add Package**.
  </Step>
</Steps>

### Option B — `Package.swift`

If you manage dependencies in a `Package.swift` manifest, add Encore to your `dependencies` and to your target:

```swift theme={null}
dependencies: [
    .package(url: "https://github.com/EncoreKit/ios-sdk", from: "1.0.0"),
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "Encore", package: "ios-sdk"),
        ]
    ),
]
```

### Verify Installation

You should now be able to import the SDK:

```swift theme={null}
import Encore
```

**Installation complete.**

***

## Next Steps

Now that the SDK is installed, continue with the integration:

* **[Configure the SDK](./configure)** - Set up your API key and initialize Encore
* **[Identify Users](./user-management)** - Learn how to identify users for offer tracking

For advanced features and complete API documentation, see the [SDK Reference](/publishers/ios/sdk-reference/overview).

***

## Already Installed?

If you've already installed the SDK and need to update to a newer version, see [Updating the SDK](/publishers/ios/guides/updating-sdk).