Swift SDK Quick Start

Before installing the SDK, make sure your project meets these minimum requirements:

• •iOS 15.0+ or macOS 12.0+
• •Swift 5.7+
• •Xcode 14+

The SDK ships as a Swift package with no third-party dependencies.

1. 1.Open your project in Xcode
2. 2.Go to File > Add Package Dependencies...
3. 3.Enter the repository URL:

1. 1.Select Up to Next Major Version with 1.0.0 as the minimum version
2. 2.Click Add Package, then select JotReview as the library to add to your target

If you manage your dependencies through a Package.swift file, add JotReview as a dependency:

Call JotReview.setup(projectId:) once at app launch, before any views are displayed. In SwiftUI, do this in your @main App struct. In UIKit, do this in application(_:didFinishLaunchingWithOptions:).

SwiftUI:

@main struct MyApp: App { init() { JotReview.setup(projectId: "proj_a1b2c3d4") }

var body: some Scene { WindowGroup { ContentView() } } } `

UIKit:

@main class AppDelegate: UIResponder, UIApplicationDelegate { func application( _ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? ) -> Bool { JotReview.setup(projectId: "proj_a1b2c3d4") return true } } `

Your project ID is available in your JotReview dashboard under Settings > Login & SSO.

After setup, show the feedback sheet from anywhere in your app:

// Present modally (works from any UIViewController or SwiftUI view) JotReview.showFeedback()

// Open directly to a specific section JotReview.showFeedback(section: .roadmap) JotReview.showFeedback(section: .updates) `

The sheet is a full native modal that presents on top of your content. Users can dismiss it with a swipe or by tapping Done.

Call JotReview.identify after login to associate feedback with a specific user:

See the Identify Users article for the full parameter reference and secure authentication.

A minimal app with JotReview fully integrated:

@main struct MyApp: App { init() { JotReview.setup(projectId: "proj_a1b2c3d4") }

var body: some Scene { WindowGroup { ContentView() } } }

struct ContentView: View { @State private var showFeedback = false

var body: some View { NavigationStack { List { Text("Welcome to My App") } .navigationTitle("Home") .toolbar { ToolbarItem(placement: .navigationBarTrailing) { Button("Feedback") { showFeedback = true } } } .jotReviewFeedback(isPresented: $showFeedback) } } } `

class HomeViewController: UIViewController { override func viewDidLoad() { super.viewDidLoad()

@objc func openFeedback() { JotReview.showFeedback() } } `