iOS SDK changelog

All notable changes to the iOS SDK are documented here. This project follows Semantic Versioning.

Versioning

Fedo versions are X.Y.Z. The X.Y part is shared across every part of the product — Android SDK, iOS SDK, backend, and dashboard all move to the same X.Y together, so the same X.Y means the same feature set everywhere. The Z is per platform: each repo bumps its own patch number independently for fixes and platform-specific work.

That is why the iOS SDK starts at 0.4.0 rather than 0.1.0 — it is not the third iOS release, it is the first one, shipping at feature parity with Android 0.4.x on the shared 0.4 line.

0.5.0 — TBD

Threaded replies, with the same feature set as Android 0.5.0.

Breaking

• FedoConfig(networkTimeout:logLevel:) removed (deprecated since 0.4.0). Use FedoConfig(networkTimeout:logHandler:) and filter on entry.level in the closure
• FedoLogLevel.none removed. It was only the floor for that initializer; no log entry carries it

Added

• Threaded replies — Reply button on each comment and a "Replying to @name" strip whose ⓧ cancels the reply and keeps the draft. Unlimited nesting; past the indent cap a reply shows "↳ Replying to @name"
• Paged comments — comments load in pages as you scroll, ending with "You're all caught up". Each thread shows its first replies inline, the rest behind "Show n more replies"
• Deleted placeholders — deleting a comment with replies leaves a "Comment deleted" placeholder and keeps the replies; a comment without replies is removed. The delete confirmation says which will happen
• Plan availability — replying needs a Plus or Pro plan. On Starter there is no Reply button and no strip; existing replies stay visible
• Toasts — confirm posting, deleting and copying, and explain failures ("This comment was deleted.", "This thread can't take more replies.", "Replies aren't available on this board."). Error toasts stay 4 s so they can be read. A failed reply keeps your text

Changed

• Header count ("1 COMMENT" / "N COMMENTS") includes replies and deleted placeholders
• A failed comment delete shows a toast instead of the "Couldn't delete comment" alert

0.4.0 — 2026-10-17

Breaking

• Min iOS bumped 16 → 17
• Public globals DEFAULT_NETWORK_TIMEOUT / DEFAULT_LOG_LEVEL removed. FedoConfig defaults unchanged
• FedoLogEntry initializer now internal. Hosts only receive entries

Added

• FedoConfig.logHandler — receive SDK logs as FedoLogEntry instead of OSLog
• Discard confirmation — when leaving feedback editor with unsaved title/details

Changed

• FedoConfig.networkTimeout now total per-request limit (hidden 60 s cap removed)
• Character limits counted in Unicode scalars like backend
• SDK strings rendered verbatim, never looked up in host bundle (always English)
• Blank setUserEmail("") now accepted so hosts can clear email
• FedoFeedbackView must be on NavigationStack; NavigationView / fullScreenCover unsupported

Fixed — user-visible

• Comment timestamps — "N days ago" up to 7 days (Android parity)
• Failed pull-to-refresh on detail shows error banner, keeps comments
• Feedback details screen — Pull-to-refresh no longer cancelled mid-flight
• Loaded comments stay visible when background reload fails
• Feedbacks screen — Pull-to-refresh failure with rows visible shows banner, not silent log
• Comments no longer flash spinner on every detail reload
• Stale refresh/comments errors cleared on successful load/post
• Comment count on list rows updates after post/delete
• Failed comment delete shows "Couldn't delete comment"
• Vote failure banner shows on detail screen, not hidden list
• Empty board shows board empty state + "Suggest a feature", not filter-empty
• Feedback posted before first successful load no longer dropped
• Delete only offered for own feedback in in_review/planned. Else "Can't Delete Feedback"
• Swipe-to-dismiss sheet with unsaved text asks to discard. Edit mode dismisses freely when unchanged
• Watermark bar matches white loading/error/thanks states on iOS
• Friendly "feedback isn't available" placeholder in Release when SDK not initialized
• .tint() now drives vote glyph, send button, comment highlight, avatar fallback
• Malformed feedback/comment item skipped + logged instead of failing whole list
• Unknown feedback status decodes as "Unknown", listed under Closed

Fixed — session / identity

• Session — app kill mid-write can't mix users' token+id
• Fresh anonymous session when API key changes
• Logout clears core token + cached feedback; drops previous user's in-flight responses
• Late token refresh after logout/user change no longer restores old user
• setUserID no longer replaced by queued anonymous-user creation
• User data no longer printed in logs

0.4.0-beta.3 — 2026-10-11

Added

• iOS 27 support — the SDK now runs on iOS 27.

Fixed

• Internal fixes and stability improvements.

0.4.0-beta.2 — 2026-10-06

Breaking Changes

• FeedbacksView renamed to FedoFeedbackView — update your call sites to FedoFeedbackView().

Changed

• Status filter moved to a toolbar menu — the filter tabs above the feedback list are replaced by a menu in the navigation bar showing the current status and its count (e.g. All · 63).
• Single initialization — calling Fedo.initialize again now logs an error and does nothing, instead of re-initializing the SDK.

0.4.0-beta.1 — first iOS release

Feature parity with the Android SDK 0.4.0.

Added

• Feedback board — FeedbacksView(), a SwiftUI view with the full flow: list (All / Mine), details, threaded comments, voting, and the feedback editor. Pushes onto the enclosing NavigationStack.
• Feedback sheet — .presentCreateFeedback(isPresented:) view modifier, a submission-only sheet (title + details) driven by a Bool binding.
• Setup — Fedo.initialize(apiKey:config:) with FedoConfig (networkTimeout, logLevel).
• Identity — setUserID, setUserDisplayName, setUserEmail, setUserProperty(_:value:), logout. Anonymous users are created automatically and merged into the identified user.
• Comment editing — users can edit their own comments.
• User device properties — device information collected and attached to the user. See User Management.
• Managed auth — session tokens stored in the Keychain, refreshed automatically, request retried on expiry.
• Requires iOS 16+, Swift 6.