> For the complete documentation index, see [llms.txt](https://docs.flexmoney.uk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flexmoney.uk/documentation/docs/installation-3.md).

# Installation

## Overview

Kommunicate provides open source live chat SDK in iOS. The Kommunicate SDK is flexible, lightweight and easily integrable. It lets you easily add real-time live chat and in-app messaging in your mobile applications and websites for customer support. The SDK is equipped with advance messaging options such as sending attachments, sharing location and rich messaging.

## Prerequisites

* Apps using Kommunicate can target iOS 10 or later<br>
* Xcode 12 or later required

## Installation

Kommunicate is available through [CocoaPods](https://guides.cocoapods.org/using/using-cocoapods.html). To install it, add the following line to your Podfile:

```
pod 'Kommunicate'
```

This is how the podfile will look:

Then run the following command:

```
pod install
```

In any file you'd like to use Kommunicate in, don't forget to import the framework as shown below:

```
import Kommunicate
```

Note: If you are using Kommunicate in an Objective-C app, then check this[sample app in Objective-C](https://github.com/Kommunicate-io/Kommunicate-Objective-C-Sample-App). Create a [wrapper file](https://github.com/Kommunicate-io/Kommunicate-Objective-C-Sample-App/blob/master/KommunicateObjcSample/KommunicateWrapper.swift) in Swift and call the functions in the wrapper from Objective-C files in your Project.

### Permissions

Add permissions for Camera, Photo Library, Microphone, Contacts and Location usage.<br>

Note: We won't be asking the users for these permissions unless they use the respective feature. Due to Apple's requirement, we have to add these permissions if we are using any of their APIs related to Camera, Microphone etc.

In your app's `Info.plist` file as ‘Source code’ and paste these permissions anywhere inside the tag.

```
<key>NSCameraUsageDescriptionkey>
<string>Allow Camerastring>
<key>NSContactsUsageDescriptionkey>
<string>Allow Contactsstring>
<key>NSLocationWhenInUseUsageDescriptionkey>
<string>Allow location sharing!!string>
<key>NSMicrophoneUsageDescriptionkey>
<string>Allow MicroPhonestring>
<key>NSPhotoLibraryUsageDescriptionkey>
<string>Allow Photosstring>
<key>NSPhotoLibraryAddUsageDescriptionkey> 
<string>Allow write accessstring>

```
