Skip to content
FeddyDocs

iOS quickstart

By the end of this page your app has a support entry point, and a message sent from it shows up in your Feddy inbox.

Prerequisites

Section titled “Prerequisites”
  • A Feddy project. Create one in the dashboard, then copy the project ID from Settings → Install.
  • Xcode 15 or later. The SDK targets iOS 15 and has no third-party dependencies.

1. Install

Section titled “1. Install”

In Xcode choose File → Add Package Dependencies… and paste:

https://github.com/FeddyLab/feddy-ios

Or add it to Package.swift:

.package(url: "https://github.com/FeddyLab/feddy-ios", from: "0.6.2")

2. Initialize

Section titled “2. Initialize”

Call configure once, before any other Feddy call. Later calls are ignored.

import Feddy


@main
struct MyApp: App {
    init() {
        Feddy.configure(projectId: "fd_XXXXXXXXXXXXXXXX")
    }
    var body: some Scene { WindowGroup { ContentView() } }
}

UIKit apps call it from application(_:didFinishLaunchingWithOptions:).

3. Add an entry point

Section titled “3. Add an entry point”

Put a row where users already look for help, usually in Settings:

Form {
    Button("Support") { Feddy.present() }
        .feddyUnreadBadge()
}

present() opens the conversation list as a sheet over whatever is on screen. presentNewConversation() skips the list and opens the compose form. Both work from SwiftUI and UIKit.

4. Verify

Section titled “4. Verify”

Run the app, open the row, and send a message. It appears in your Feddy inbox. Reply from the inbox; the reply shows up in the sheet and the row’s badge shows 1 until the user reads it.

Next steps

Section titled “Next steps”