iOS · SwiftUI · SDK 0.0.24

# iOS quickstart

Install Mobile Joe and display a FAQ published from your dashboard.

## Before you start

- An iOS app using SwiftUI, with iOS 17+, Swift 6.2+, and Xcode 26+.
- A Mobile Joe account with API access and an app created in the [dashboard](https://app.mobilejoe.dev/).
- The public SDK API key from that app's **App Settings**. The **Set up SDK** page provides the configuration below with your key already filled in.

This guide uses SDK **0.0.24**. Choose this exact package version so the examples match the installed SDK.

## Install the SDK

1. In Xcode, choose **File → Add Package Dependencies…**.
2. Enter this package URL:

```text
https://github.com/MobileJoeDev/mobilejoe-ios.git
```

Set the dependency rule to **Exact Version** , enter **0.0.24** , and add both `MobileJoe` and `MobileJoeUI` to your app target.

## Configure your app

In your existing SwiftUI `App` type, import `MobileJoe` and configure it in `.task` at startup. Keep your app's existing name and root view.

```swift
import SwiftUI
import MobileJoe

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        .task {
          try? await Joe.configure(withAPIKey: "YOUR_API_KEY")
        }
    }
  }
}
```

Replace `YOUR_API_KEY` with the key for the same dashboard app whose content you want to show.

`configure` is `async throws`. This minimal example ignores errors with `try?`; use `do`/`catch` to handle them. Await configuration before starting dependent SDK operations.

## Add the FAQ screen

Replace your starter `ContentView` with this example, or add its navigation link to your existing `NavigationStack`.

```swift
import SwiftUI
import MobileJoeUI

struct ContentView: View {
  var body: some View {
    NavigationStack {
      List {
        NavigationLink("FAQs") {
          FAQView(
            presentationMode: .inNavigationStack,
            configuration: .standard(recipient: "")
          )
        }
      }
      .navigationTitle("Help")
    }
  }
}
```

`FAQView` loads its own data. Use `.inNavigationStack` when the surrounding navigation stack is provided by your app. The empty support recipient hides the email contact link; replace it with your support address to show that link.

## Verify your integration

1. Select the matching app in the dashboard and open **FAQs**.
2. Create a FAQ with a recognizable question and answer, then publish it.
3. Build and run your iOS app. Open **FAQs** from the Help screen.
4. Confirm that your published question appears. Open it and check the answer.
5. Edit the answer in the dashboard, then pull to refresh the FAQ list in your app. The updated answer should be available.

A successful integration displays your own published content. Previews and sample fixtures do not verify the connection to your dashboard app.

## If the FAQ does not appear

- **Wrong app or key:** check that the SDK key and published FAQ belong to the same dashboard app.
- **Unpublished content:** a draft or archived FAQ is not delivered to your app.
- **Changes seem delayed:** FAQs request data on every load, including pull to refresh. Debug mode is not needed for FAQs.
- **Configuration fails:** use `do`/`catch` around `try await Joe.configure` to inspect the error. Check network connectivity, the API key, and account API access, then relaunch to retry.

## Before you ship

Without `appUserID`, the SDK uses a locally persisted anonymous identity. For signed-in users, pass a stable, opaque account ID during configuration or call `try await Joe.identify(appUserID:)` after sign-in. Avoid using an email address or phone number.

## Next steps

Continue with the [FAQ guide](https://docs.mobilejoe.dev/ios/faqs.md) for presentation and support options, or add [Feature Plans](https://docs.mobilejoe.dev/ios/feature-plans.md) and [Alerts](https://docs.mobilejoe.dev/ios/alerts.md) to your app.