Adding the Hot Takes SDK to your app

The Hot Takes SDK ships as a Swift package for iOS 17 and later, with zero third-party dependencies.

1. In Xcode, choose File → Add Package Dependencies and add the package by its git URL. Add the HotTakes library to your app target.
2. Create a project at hottakes.app and copy its project key (it looks like ht_pk_…).
3. Call HotTakes.start once at app launch with the key and the API base URL. The full two-line snippet is in the Get set up guide.

Call start unconditionally: don't wrap it in #if DEBUG. TestFlight builds are Release builds, so a debug guard removes the SDK from the exact builds your reviewers use. The SDK manages this itself: it's active in development and TestFlight builds and stays dormant in a real App Store build, so the unconditional call is always safe to ship.

Two things to get right: use the exact API base URL from the guide (never the bare hottakes.app domain, which breaks authenticated calls behind a redirect), and add a microphone usage description (NSMicrophoneUsageDescription) to your Info.plist so reviewers can narrate screen recordings.

Screenshots work in the iOS Simulator; screen recording needs a real device. If the capture pill doesn't appear, confirm start runs at launch and the key matches a live project.

Still stuck? Write to us and we'll figure it out together.