Capture feedback in the moment
Use the SDK when users should not leave the app to report a bug or request a feature. A settings link, help screen, or contextual feedback button can open the Portal directly.
iOS Feedback SDK
iOS SDK for hosted or fully custom feedback experiences.
Gleam's iOS SDK gives Swift teams two paths: present the official hosted Portal, or use SDK APIs to build a custom feedback board, announcement feed, and notification center in SwiftUI or UIKit.
iOS SDKSwiftUI + UIKit
A small bridge from your app to Gleam data and Portal surfaces.
Add the Swift package, pass the user context you already have, then present the official Portal or render feedback, announcements, notifications, and preferences in your own UI.
Portal presetFeedback APIAnnouncementsNotification inboxAPNs routing
Your iOS app
SwiftUI or UIKit entry point
Gleam SDK
Portal preset or SDK APIs
Native surfaces
Feedback, updates, and inbox
The problem
What breaks without a follow-up path
Asking users to leave the app, open a forum, or sign in again kills the moment when feedback is most useful. By the time they reach a web form, the context is gone.
The solution
How Gleam handles it
Drop Gleam into your iOS project and choose the surface that fits your app. Use the Portal preset for the full Gleam experience, or call the feedback, announcements, notification, preference, and push APIs from your own native UI.
Capabilities
Built for the daily shipping rhythm.
Each product area is designed to stay lightweight enough for a small team, while keeping the data structured enough for automation, reporting, and agent-assisted work.
Hosted Portal preset
Native feedback API
Announcements Data API
Notification inbox API
Anonymous sessions
Signed-in account sync
Push preferences and APNs
Routed notification URLs
Use cases
Where iOS SDK fits in the product loop.
These are the situations where the feature should be visible to users or connected to an internal product workflow.
Build a custom native feedback board
If the feedback experience should match the rest of your app, fetch boards and posts with the SDK, render them in SwiftUI or UIKit, and submit posts, votes, and comments through the same no-login session.
Create your own update center
Use announcement and notification APIs to show a custom in-app update feed, unread notification state, and preference controls without sending users to a separate web view.
Let anonymous users start
Anonymous sessions help apps collect useful feedback before account creation. Signed identity can be added later when the app knows the current user and wants profile-aware follow-up.
Connect feedback to mobile follow-up
Swift teams can combine Portal UI, notification polling, push preferences, and APNs device token registration so feedback does not end at submission.
Workflow
From signal to follow-through.
1
Install
Add the Swift package and configure your Gleam project key.
2
Choose
Use the Portal preset, native feedback APIs, or custom announcement and notification APIs.
3
Follow up
Keep anonymous users, signed identity, preferences, APNs, and routed notification URLs on the same session.
Implementation
Operational details that matter before launch.
Gleam is designed to start small, but each feature still has a few product decisions worth making before inviting users.
Choose Portal preset or API-owned UI
Initialize Gleam once with the project ID and SDK key. Present the Portal when you want Gleam's complete H5 flow, or call SDK APIs when your app owns the feedback, announcement, and notification screens.
Keep custom UI on the SDK session
Custom feedback and notification screens should still call start() first. That preserves no-login anonymous users, signed identity upgrades, project headers, and the same moderation and follow-up pipeline as the Portal.
Keep signed identity server-side
The iOS app should never generate identity tokens. Your backend signs short-lived HS256 tokens after authenticating the user, then the SDK exchanges that token for a Gleam session.
Plan APNs after the Portal works
The quickest launch path is Portal UI first. Add APNs registration after the session, identity, notification permission, and deep-link routing have been tested in the host app.
Outcomes
Why teams use iOS SDK inside Gleam.
Portal preset or custom native UI
Three-minute setup path
No required account registration
More features