# Installation
To integrate Stream Chat in your app, you can use one of the following dependency managers:
- [**Swift Package Manager**](#swift-package-manager)
- [**CocoaPods**](#cocoapods)
We also provide pre-built XCFramework support, read more [here](#xcframeworks).
### Swift Package Manager
Open your `.xcodeproj`, select the option "Add Package..." in the File menu, and paste the URL for the library you want to integrate:
- For the LLC (**StreamChat**) use:
- `https://github.com/getstream/stream-chat-swift`
- For the UIKit components (**StreamChatUI**, which depends on **StreamChat**) use:
- `https://github.com/getstream/stream-chat-swift`
- For the SwiftUI components (**StreamChatSwiftUI**, which depends on **StreamChat**) use:
- `https://github.com/getstream/stream-chat-swiftui`
➤ Do you want to use XCFrameworks? (Click to read more)
Our XCFrameworks are built with **Swift 5.7**. In order to use them you need **Xcode 14** or above
You can learn more about [our Module Stable XCFrameworks here](#xcframeworks)
- For the LLC (**StreamChat**) use:
- `https://github.com/getstream/stream-chat-swift-spm`
- For the UIKit components (**StreamChatUI**, which depends on **StreamChat**) use:
- `https://github.com/getstream/stream-chat-swift-spm`
After introducing the desired URL, Xcode will look for the Packages available in the repository and automatically select the latest version tagged. Press next and Xcode will download the dependency.
Based on the repository you select you can find 3 different targets: StreamChat, StreamChatUI and StreamChatSwiftUI.
- If you want to use the UIKit components, select **StreamChatUI**.
- If you want to use the SwiftUI components, select **StreamChatSwiftUI**.
- If you don't need any UI components, select **StreamChat**.
After you press finish, it's done.
Because StreamChat SDKs have to be distributed with its resources, the minimal Swift version requirement for this installation method is 5.6. If you need to support older Swift version, please install it using CocoaPods.
_More information about Swift Package Manager [can be found here](https://www.swift.org/package-manager/)_
### CocoaPods
In your project's `Podfile`, add one of these options
- For the LLC (**StreamChat**) use:
- `pod 'StreamChat', '~> 4.0.0'`
- For the UIKit components (**StreamChatUI**, which depends on **StreamChat**) use:
- `pod 'StreamChatUI', '~> 4.0.0'`
- For the SwiftUI components (**StreamChatSwiftUI**, which depends on **StreamChat**) use:
- `pod 'StreamChatSwiftUI', '~> 4.0.0'`
➤ Do you want to use XCFrameworks? (Click to read more)
Our XCFrameworks are built with **Swift 5.7**. In order to use them you need **Xcode 14** or above
You can learn more about [our Module Stable XCFrameworks here](#xcframeworks)
- For the LLC (**StreamChat**) use:
- `pod 'StreamChat-XCFramework', '~> 4.6.0'`
- For the UIKit components (**StreamChatUI**, which depends on **StreamChat**) use:
- `pod 'StreamChatUI-XCFramework', '~> 4.6.0'`
Example: If you want to use the UIKit components, it should look similar the snippet below.
```ruby
target 'MyProject' do
use_frameworks!
# Pods for MyProject
pod 'StreamChatUI', '~> 4.0.0'
end
```
StreamChatUI and StreamChatSwiftUI pod will automatically include the StreamChat dependency. If you want just the StreamChat dependency, without the UI components, use StreamChat as shown above.
Now that we’ve modified our Podfile, let’s go ahead and install the project dependencies via the terminal with one simple command:
```bash
pod install --repo-update
```
The above command will generate the **MyProject.xcworkspace** file automatically.
With our workspace now containing our Pods project with dependencies, as well as our original project, let’s go ahead and move over to Xcode to complete the process.
_More information about CocoaPods [can be found here](https://cocoapods.org/)._
## XCFrameworks
In an effort to have [**Module Stability**](https://www.swift.org/blog/library-evolution/), we have started distributing **pre-built XCFrameworks** starting **_4.6.0_**
Our XCFrameworks are built with Swift 5.7. In order to use them you need Xcode 14 or above.
An **XCFramework** is a package that contains binaries for multiple architectures/platforms, but only the particular slice of that package required for your architecture/platform will be used.
**Benefits of XCFrameworks:**
- Conveniently import a single package
- Supports all platforms and architectures (We support iOS in StreamChatUI and iOS/macOS in StreamChat)
- No more fat binaries. No more architectures stripping
> Does this mean that from now on, I will need to import Stream manually?
**No**, all the known dependency managers support this format, and this most likely happens without you even noticing.
**Module Stability:**
While ABI Stability was allowing us to have code written with different Swift versions in the same runtime, Module Stability enables us to use a library built in a particular version of the compiler running in a different version of the compiler (Think of a framework that is built using Swift X to work on an app built with Swift X+1).
## Add Usage Descriptions to Info.plist
Add the [NSPhotoLibraryUsageDescription](https://developer.apple.com/documentation/bundleresources/information_property_list/nsphotolibraryusagedescription) key in your Info.plist with a description of use.
Add the [NSPhotoLibraryAddUsageDescription](https://developer.apple.com/documentation/bundleresources/information_property_list/nsphotolibraryaddusagedescription) key in your Info.plist with a description of use.
Add the [NSCameraUsageDescription](https://developer.apple.com/documentation/bundleresources/information_property_list/nscamerausagedescription) key in your Info.plist with a description of use.
---
This page was last updated at 2026-03-13T13:13:44.452Z.
For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/ios/basics/integration/](https://getstream.io/chat/docs/sdk/ios/basics/integration/).