From 9c29e12b197b692022dfbc5acb885a03c0410c47 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Wed, 28 Jan 2026 15:59:27 -0600 Subject: [PATCH] docs: Document Apple Bundle IDs for native iOS/macOS app sign-in (#1139) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit [Open this suggestion in Promptless to view citations and reasoning process](https://app.gopromptless.ai/change-history/2b709902-b62c-491c-ad6d-966069ad5ea7) Adds documentation for configuring Apple Bundle IDs in the Stack Auth dashboard, which is required for native iOS/macOS apps using Apple Sign In. The new "Native App Configuration" section explains that Bundle IDs are needed in addition to the existing web OAuth setup when using the Swift SDK's native `ASAuthorizationController` flow, and provides step-by-step instructions for adding Bundle IDs in the Apple authentication method modal. ### Trigger Events
stack-auth/stack-auth commit (dev): c8694c7 [Fix] [Feat] Update OAuth Sign-In and Get Token Functions to Work (#1130)
**Promptless Research** (1 GitHub PR) - [Reviewed stack-auth/stack-auth#1130](https://github.com/stack-auth/stack-auth/pull/1130) **Agent Response** > I've completed my analysis of PR #1130 and created a documentation suggestion. > > ## Summary > > **PR #1130** adds Apple Native Sign In for iOS/macOS apps, which requires users to configure Bundle IDs in the Stack Auth dashboard (in addition to the existing web OAuth setup with Service IDs). > > ### What I found: > - An existing suggestion already documents the Swift SDK and its OAuth flows > - However, the **Apple authentication provider page** didn't mention Bundle IDs configuration for native apps > > ### Documentation created: > > **New suggestion: "Document Apple Bundle IDs for native iOS/macOS app sign-in"** > > I added a new "Native App Configuration (iOS/macOS)" section to the Apple authentication page that: > - Explains that native iOS/macOS apps using the Swift SDK require Bundle ID configuration > - Clarifies that this is in addition to the web OAuth setup (not a replacement) > - Provides step-by-step instructions for adding Bundle IDs in the Stack Auth dashboard > - Notes that Bundle IDs are only required for native apps, not web applications > > This complements the existing Swift SDK documentation suggestion by covering the Apple-specific dashboard configuration that native app developers need to complete.
--- **Help us improve Promptless** — If this suggestion missed the mark, please [share quick feedback](https://app.gopromptless.ai/change-history/2b709902-b62c-491c-ad6d-966069ad5ea7?openFeedback=1). *If you want Promptless to make further changes on this PR, feel free to leave a comment tagging Promptless (It won't show up in the user drop down but Promptless will get it!)* Co-authored-by: promptless[bot] <179508745+promptless[bot]@users.noreply.github.com> Co-authored-by: Madison --- .../(guides)/concepts/auth-providers/apple.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/content/docs/(guides)/concepts/auth-providers/apple.mdx b/docs/content/docs/(guides)/concepts/auth-providers/apple.mdx index b25b44796..464d01f52 100644 --- a/docs/content/docs/(guides)/concepts/auth-providers/apple.mdx +++ b/docs/content/docs/(guides)/concepts/auth-providers/apple.mdx @@ -67,6 +67,23 @@ You will need to create an Apple Developer account, and generate an Apple Servic +## Native App Configuration (iOS/macOS) + +Native iOS and macOS apps using the Stack Auth Swift SDK require Bundle ID configuration in addition to the web OAuth setup above. Native apps use Apple's native Sign in with Apple flow (`ASAuthorizationController`) instead of web-based OAuth. + + +Bundle IDs are only required for native iOS/macOS apps. Web applications only need the Service ID configuration described above. + + +### Add Your Bundle IDs + +1. On the Stack Auth dashboard, navigate to **Auth Methods** and select your Apple provider. +2. In the Apple configuration modal, add your app's **Bundle ID** (e.g., `com.yourdomain.app`). This is the same Bundle ID from your App ID in Apple Developer Portal (Step 1 above). +3. If you have multiple apps (e.g., separate iOS and macOS apps), add all their Bundle IDs. +4. Click **Save**. + +Your native app can now use `signInWithOAuth(provider: "apple")` from the Swift SDK. + ### Need More Help? - Check the [Sign in with Apple Documentation](https://developer.apple.com/sign-in-with-apple/get-started/)