> ## Documentation Index
> Fetch the complete documentation index at: https://gleanfeed.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS SDK overview

> Present Glean Feed feedback, roadmap, and changelog inside your iOS app.

The Glean Feed iOS SDK puts your feedback board, roadmap, and changelog inside your app—in a native sheet, with your branding and signed-in customers—instead of sending them to Safari.

It's a thin Swift package: native SwiftUI and UIKit entry points around your hosted Glean Feed portal, loaded in a `WKWebView`. You get the full portal (submitting, voting, commenting, statuses) without re-implementing any of it natively.

<Note>
  **Beta.** The API may change before `1.0.0`. Pin an exact version and review [GitHub
  Releases](https://github.com/MSW-Digital/glean-feed-ios-sdk/releases) before upgrading.
</Note>

## Choose the iOS SDK when

Use the iOS SDK when you ship a native iPhone app and want the ready-made Glean Feed portal experience inside it. The SDK supplies SwiftUI and UIKit presentation APIs around the hosted portal, plus signed identity, unread counts, and optional diagnostics.

Choose another path when:

| Goal                                         | Start with                          |
| -------------------------------------------- | ----------------------------------- |
| Manage Glean Feed from an agent or backend   | [API & MCP](/developers)            |
| Build a custom feedback or updates UI        | [Headless SDK](/headless/overview)  |
| Embed the ready-made experience in a web app | [Embed Glean Feed](/widget/install) |

## Requirements

* **iOS 14+**
* **Swift 5.9+**, Swift Package Manager
* A Glean Feed workspace with the portal enabled

## What it does

* `setup` once at launch, then present **feedback**, **roadmap**, or **changelog** from SwiftUI or UIKit.
* Optional **signed identity** so a logged-in customer's feedback ties to their account—the signature is generated on your backend, never in the app.
* An **unread count** for a native badge or "What's new" dot.
* Optional **diagnostics** with app, OS, and SDK versions only—never logs, screenshots, tokens, or personal information.

## What it does not do (v1)

* No fully native feedback/roadmap/changelog UI — it presents the hosted portal.
* No Android, React Native, Flutter, or macOS.
* No push notifications, app-icon badges, background refresh, or file attachments.

## Supported path

<CardGroup cols={2}>
  <Card title="Install" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/code.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=15116d3d5d15173f6794d19222b5cd17" href="/ios-sdk/install" width="24" height="24" data-path="icons/code.svg">
    Check requirements, add version 0.1.2, initialize, and open your first view.
  </Card>

  <Card title="Identify customers" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/key.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=bef0e09f655d6e92652b5049ef64ab72" href="/ios-sdk/identity" width="24" height="24" data-path="icons/key.svg">
    Connect signed-in customers with server-signed identity.
  </Card>

  <Card title="Unread count" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/bell.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=88a1fd94f6cfb116849ee9573acf8521" href="/ios-sdk/notifications" width="24" height="24" data-path="icons/bell.svg">
    Show a native badge for signed-in customers.
  </Card>

  <Card title="Diagnostics & privacy" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/sliders.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=8ed90e648bc43bc8c327cddf7024558d" href="/ios-sdk/diagnostics" width="24" height="24" data-path="icons/sliders.svg">
    Send a fixed set of app and OS version details only when you choose.
  </Card>
</CardGroup>

Finish with [troubleshooting](/ios-sdk/troubleshooting) if installation, identity, presentation, notifications, or diagnostics do not behave as expected.