# Install KaraDesk in your iOS app

Add the Swift package, start KaraDesk and open the messenger.

The KaraDesk iOS SDK brings the whole messenger into your app: conversations, your help center and live replies. It works on iOS 17 and later.

### 1. Create an iOS app in KaraDesk

Go to **Settings → Apps**, click **New app** and choose iOS. Keep your space ID and app ID handy, you'll need them in a moment.

### 2. Add the package

In Xcode, choose **File → Add Package Dependencies…**, paste this URL and add **KaraDesk** to your app target:

```
https://github.com/KaraDesk/karadesk-ios
```

### 3. Start KaraDesk

Initialize KaraDesk once when your app launches:

```
KaraDesk.initialize(spaceID: "YOUR_SPACE_ID", appID: "YOUR_APP_ID")
```

### 4. Open the messenger

```
KaraDesk.present()
```

That opens the messenger on its home screen, just like the launcher on your website.

### Signing users in

When someone signs in to your app, let KaraDesk know who they are so their conversations follow them across devices:

```
try await KaraDesk.login(KaraDesk.User(id: user.id, email: user.email))
```

Call `KaraDesk.logout()` when they sign out. For everything else the SDK can do, see the [README on GitHub](https://github.com/KaraDesk/karadesk-ios).