Skip to content

docs: Enhance Apple Sign-In setup and configuration documentation#466

Open
Zfinix wants to merge 3 commits intomainfrom
chore/update-sign-in-with-apple-docs
Open

docs: Enhance Apple Sign-In setup and configuration documentation#466
Zfinix wants to merge 3 commits intomainfrom
chore/update-sign-in-with-apple-docs

Conversation

@Zfinix
Copy link
Copy Markdown
Contributor

@Zfinix Zfinix commented Apr 14, 2026

Problem

The Sign in with Apple docs lacked screenshots for the Apple Developer Portal setup, had no clear separation between what iOS/macOS, Android, and Web each require, and didn't explain key gotchas (raw .p8 key vs pre-generated JWT, HTTPS-only redirect URIs, YAML indentation). There was also no troubleshooting page.

Solution

  • Setup page — Added 8 screenshots for the App ID, Service ID, and key creation steps. Added a platform requirements table, warnings for common mistakes, and the Android intent filter snippet.
  • Configuration page — Converted parameter tables to bullet lists to match other provider pages. Added an AppleIdpConfig parameter reference.
  • Troubleshooting page (new) — Setup checklist and 10 documented failure scenarios with cause and fix for each.

@Zfinix Zfinix requested a review from Swiftaxe April 14, 2026 08:32
@Zfinix Zfinix self-assigned this Apr 14, 2026
@Zfinix Zfinix requested a review from vlidholt April 14, 2026 08:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant