SDKs

Swift SDK

Copy page

The Swift SDK provides UI components and API helpers to integrate Bible content into iOS and iPadOS applications with minimal setup.

Installation with Swift Package Manager

Add the SDK as a dependency in Xcode:

1. Register your app on the YouVersion Platform Portal and obtain an App Key.
2. In Xcode, open File → Add Package Dependencies…
3. Enter the repository URL https://github.com/youversion/platform-sdk-swift.git and choose Up to Next Major Version.

CocoaPods

Alternatively, if you use CocoaPods:

Code
 
pod 'YouVersionPlatform', '~> 1.0'

And then in your terminal:

Code
 
pod install

Configure the SDK

Sign up at platform.youversion.com to get your free App Key.

Call YouVersionPlatform.configure once during application startup to configure it with your App Key. A common pattern is to perform the configuration inside your @main App initializer.

Code
 
import SwiftUI
import YouVersionPlatform

@main
struct SampleApp: App {
    init() {
        YouVersionPlatform.configure(appKey: "YOUR_APP_KEY_HERE")
    }

    var body: some Scene {
        // ...
    }
}

Display Content with BibleWidgetView

The SDK ships with SwiftUI components, including BibleWidgetView, which renders a passage given its reference. Provide a BibleReference describing the version, book, and verse range you want to display, and optionally adjust the font size.

Code
 
import SwiftUI
import YouVersionPlatform

struct ExampleWidgetView: View {
    var body: some View {
        BibleWidgetView(
            reference: BibleReference(
                versionId: 111, bookUSFM: "2CO", chapter: 1, verseStart: 3, verseEnd: 4
            ),
            fontSize: 18
        )
    }
}

#Preview {
    ExampleWidgetView()
}

The widget will fetch and format the passage automatically.

Example code

See the SampleApp project in the Examples folder to see the code required to display the YouVersion Verse of the Day, and also the BibleReaderView which is a complete Bible reader suitable for embedding into a tab in your application.