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

# Installation

> Add SpendOwl to your iOS project

## Swift Package Manager

SpendOwl is distributed via Swift Package Manager, the recommended way to add dependencies in modern iOS projects.

### Xcode UI

<Steps>
  <Step title="Open Package Dependencies">
    In Xcode, select your project in the navigator, then go to **Package Dependencies** tab.
  </Step>

  <Step title="Add Package">
    Click the **+** button to add a new package.
  </Step>

  <Step title="Enter URL">
    In the search field, enter:

    ```
    https://github.com/spendowl/spendowl-ios
    ```
  </Step>

  <Step title="Choose Version">
    Select **Up to Next Major Version** with `1.0.0` as the minimum.
  </Step>

  <Step title="Add to Target">
    Select your app target and click **Add Package**.
  </Step>
</Steps>

### Package.swift

If you're using a `Package.swift` file:

```swift theme={null}
dependencies: [
    .package(url: "https://github.com/spendowl/spendowl-ios", from: "1.0.0")
]
```

Then add SpendOwl to your target:

```swift theme={null}
.target(
    name: "YourApp",
    dependencies: [
        .product(name: "SpendOwl", package: "spendowl-ios")
    ]
)
```

## Requirements

| Requirement | Minimum Version |
| ----------- | --------------- |
| iOS         | 15.0            |
| macOS       | 12.0            |
| Xcode       | 15.0            |
| Swift       | 5.9             |

## Framework Dependencies

SpendOwl uses these Apple frameworks (automatically linked):

* **Foundation** — Core Swift types and networking
* **StoreKit** — Purchase tracking (StoreKit 2)
* **AdServices** — Apple Search Ads attribution tokens

<Note>
  No third-party dependencies. SpendOwl is a pure Swift package.
</Note>

## Verify Installation

After adding the package, verify the installation by importing SpendOwl:

```swift theme={null}
import SpendOwl

// Check SDK version
print(SpendOwl.sdkVersion) // "1.0.0"
```

If the import succeeds without errors, you're ready to [configure the SDK](/sdk/configuration).

## Updating

To update SpendOwl:

1. Select your project in Xcode
2. Go to **Package Dependencies**
3. Right-click on `spendowl-ios`
4. Select **Update Package**

<Tip>
  Enable automatic updates in Xcode to get the latest bug fixes and features.
</Tip>

## Next Steps

<Card title="Configuration" icon="gear" href="/sdk/configuration">
  Configure the SDK with your API key
</Card>