docs: Document Apple Bundle IDs for native iOS/macOS app sign-in by promptless[bot] · Pull Request #1139 · hexclave/stack-auth

promptless · 2026-01-28T17:06:50Z

Open this suggestion in Promptless to view citations and reasoning process

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

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.

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!)

promptless · 2026-01-28T17:06:52Z

  </Step>
 </Steps>

+## Native App Configuration (iOS/macOS)


Citation: PR #1130 adds Apple Native Sign In for iOS/macOS apps. The backend verifies Apple identity tokens against configured Bundle IDs (see apps/backend/src/app/api/latest/auth/oauth/callback/apple/native/route.tsx and the appleBundles config in apps/backend/src/lib/projects.tsx). The PR description states: "To use the Apple native sign in, users will have to...update the Stack-Auth Authentication Methods dashboard apple modal with the relevant fields."
View source

vercel · 2026-01-28T17:06:54Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
stack-backend	Ready	Preview, Comment	Jan 28, 2026 10:06pm
stack-dashboard	Ready	Preview, Comment	Jan 28, 2026 10:06pm
stack-demo	Ready	Preview, Comment	Jan 28, 2026 10:06pm
stack-docs	Ready	Preview, Comment	Jan 28, 2026 10:06pm

coderabbitai · 2026-01-28T17:06:58Z

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

🔍 Trigger a full review

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

CLAassistant · 2026-01-28T17:07:02Z

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
1 out of 2 committers have signed the CLA.

✅ madster456
❌ promptless[bot]
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

greptile-apps · 2026-01-28T17:09:31Z

Greptile Overview

Greptile Summary

Added a new "Native App Configuration (iOS/macOS)" section to the Apple authentication documentation that explains Bundle ID configuration requirements for native iOS/macOS apps using the Swift SDK.

Key changes:

Documented that Bundle IDs are required for native apps in addition to the existing web OAuth setup (Service IDs)
Provided step-by-step instructions for adding Bundle IDs in the Stack Auth dashboard
Clarified that Bundle IDs are only needed for native apps using ASAuthorizationController, not web applications
Referenced the Swift SDK's signInWithOAuth(provider: "apple") method

The documentation accurately reflects the implementation added in PR #1130, which introduced native Apple Sign In support and Bundle ID validation on the backend.

Confidence Score: 5/5

This PR is safe to merge with no risk
Documentation-only change that accurately describes a feature already implemented in PR [Fix] [Feat] Update OAuth Sign-In and Get Token Functions to Work #1130, with clear instructions and proper cross-references
No files require special attention

Important Files Changed

Filename	Overview
docs/content/docs/(guides)/concepts/auth-providers/apple.mdx	Added native iOS/macOS configuration section documenting Bundle ID requirements for Apple Sign In

Sequence Diagram

sequenceDiagram
    participant Dev as iOS/macOS Developer
    participant Docs as Apple Auth Docs
    participant Portal as Apple Developer Portal
    participant Dashboard as Stack Auth Dashboard
    participant App as Native App
    participant SDK as Swift SDK
    participant Backend as Stack Auth Backend

    Note over Dev,Backend: Setup Process (One-time Configuration)
    Dev->>Docs: Read Apple auth setup guide
    Docs->>Dev: Shows web OAuth setup (Steps 1-4)
    Dev->>Portal: Create App ID with Bundle ID
    Dev->>Portal: Create Service ID for web OAuth
    Dev->>Portal: Configure domains & return URLs
    Dev->>Portal: Create private key
    Dev->>Dashboard: Configure Apple provider with Service ID
    
    Note over Dev,Backend: Native App Configuration (NEW)
    Docs->>Dev: Shows Native App Configuration section
    Dev->>Dashboard: Open Apple provider modal
    Dev->>Dashboard: Add Bundle ID(s) for native apps
    Dashboard->>Backend: Store Bundle IDs in appleBundles config
    
    Note over Dev,Backend: Runtime: Native Sign In Flow
    App->>SDK: Call signInWithOAuth(provider: "apple")
    SDK->>App: Use native ASAuthorizationController
    App->>Backend: POST /auth/oauth/callback/apple/native
    Backend->>Backend: Verify JWT audience matches Bundle ID
    Backend->>App: Return access_token & refresh_token

greptile-apps

_{1 file reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}

promptless · 2026-01-28T17:17:20Z

🔧 I noticed that some CI checks failed for this PR. I'm investigating the failures and will work on fixing them.

promptless · 2026-01-28T17:19:02Z

Promptless escalated the following message to you. If you respond, please remember to tag Promptless:

I've investigated the CI failure on PR #1139 (Document Apple Bundle IDs for native iOS/macOS app sign-in).

The failing check is a TypeScript lint error in apps/mock-oauth-server/src/index.ts (line 309) - a pre-existing issue in the mock-oauth-server package that's unrelated to my documentation changes. My PR only modifies the Apple authentication documentation file.

Since this is a codebase lint error rather than a documentation issue, this would need to be fixed by the engineering team in the main codebase. The documentation changes themselves are ready for review.

promptless · 2026-01-28T17:19:59Z

🔧 I noticed that some CI checks failed for this PR. I'm investigating the failures and will work on fixing them.

promptless · 2026-01-28T17:23:32Z

🔧 I noticed that some CI checks failed for this PR. I'm investigating the failures and will work on fixing them.

promptless · 2026-01-28T18:18:14Z

🔧 I noticed that some CI checks failed for this PR. I'm investigating the failures and will work on fixing them.

promptless · 2026-01-28T18:20:52Z

Promptless escalated the following message to you. If you respond, please remember to tag Promptless:

I've investigated the CI failure on the "Document Apple Bundle IDs for native iOS/macOS app sign-in" PR.

Finding: The failure is a database migration error in the backend code, unrelated to my documentation changes:

PrismaClientKnownRequestError: 
Raw query failed. Code: `42P01`. Message: `relation "Event" does not exist`

This occurs during migration 20260201240000_event_created_at_index, which tries to create an index on an "Event" table that doesn't exist in the schema.

My documentation changes only modify docs/content/docs/(guides)/concepts/auth-providers/apple.mdx to add the Native App Configuration section for Bundle IDs, which is syntactically valid.

This backend migration issue needs to be resolved by your engineering team. Once fixed, the CI checks should pass for this documentation PR. The documentation content is ready for review.

promptless · 2026-01-28T18:29:39Z

🔧 I noticed that some CI checks failed for this PR. I'm investigating the failures and will work on fixing them.

Document Apple Bundle IDs for native iOS/macOS app sign-in

d95d562

promptless Bot commented Jan 28, 2026

View reviewed changes

github-actions Bot assigned promptless[bot] Jan 28, 2026

greptile-apps Bot reviewed Jan 28, 2026

View reviewed changes

Merge branch 'dev' into promptless/document-apple-bundle-ids

4eec797

madster456 self-requested a review January 28, 2026 21:57

Merge branch 'dev' into promptless/document-apple-bundle-ids

72cdbb7

madster456 merged commit 9c29e12 into dev Jan 28, 2026
19 of 27 checks passed

madster456 deleted the promptless/document-apple-bundle-ids branch January 28, 2026 21:59

Conversation

promptless Bot commented Jan 28, 2026

Trigger Events

Summary

What I found:

Documentation created:

Uh oh!

promptless Bot Jan 28, 2026

Choose a reason for hiding this comment

Uh oh!

vercel Bot commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Jan 28, 2026

Review skipped

Uh oh!

CLAassistant commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

greptile-apps Bot commented Jan 28, 2026

Greptile Overview

Greptile Summary

Confidence Score: 5/5

Important Files Changed

Sequence Diagram

Uh oh!

greptile-apps Bot left a comment

Choose a reason for hiding this comment

Uh oh!

promptless Bot commented Jan 28, 2026

Uh oh!

promptless Bot commented Jan 28, 2026

Uh oh!

promptless Bot commented Jan 28, 2026

Uh oh!

promptless Bot commented Jan 28, 2026

Uh oh!

promptless Bot commented Jan 28, 2026

Uh oh!

promptless Bot commented Jan 28, 2026

Uh oh!

promptless Bot commented Jan 28, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

vercel Bot commented Jan 28, 2026 •

edited

Loading

CLAassistant commented Jan 28, 2026 •

edited

Loading