Feddy Docs
iOS SDKOverview

Overview

Start here to understand the Feddy iOS SDK surface area — what ships in the box and where each piece fits.

The Feddy iOS SDK is a single Swift package that gives your app two drop-in SwiftUI views and a small async API for building anything custom on top of the same data.

What's in the box

SurfacePurpose
Feddy.configure(...)One-line bootstrap with your Project ID.
Feddy.identify(...)Attribute writes to a real user identity. Optional.
Feddy.submitRequest(...)Programmatic submit. Fire-and-forget, never throws.
Feddy.fetchRequests(...) etcAsync reads for fetch / vote / comment when you need a custom UI.
RequestComposeViewDrop-in feedback form, localized in 7 languages (en / zh-Hans / zh-Hant / es / ja / de / fr).
RequestListViewDrop-in roadmap viewer with upvote and detail navigation.

Two API styles

The SDK is split deliberately so fire-and-forget writes never need do/catch:

  • Synchronous, never-throws: configure, identify, submitRequest, logout. Errors log to the console and queue for retry where it makes sense.
  • Async / throws: fetchRequests, fetchRequest, upvote, fetchComments, addComment. Errors surface as FeddyError.network or FeddyError.http(status:code:message:).

Reading order

The next three pages take you from zero to fully integrated:

  1. Installation — Swift Package Manager install, Project ID setup, and the Feddy.configure(...) call at app launch.
  2. Authentication — identifying signed-in users and how anonymous-first attribution reconciles to a real user later.
  3. Common flows — submit feedback, surface the roadmap, build a custom UI on top of the async API, and handle errors.

Status

The iOS SDK is at v0.7.x, currently in beta. Breaking changes between minor versions are called out on the GitHub releases page. After 1.0, the SDK follows strict semver — minor / patch releases will not break callers.

On this page