diff --git a/packages/apple-signin/README.md b/packages/apple-signin/README.md index f375217..b701ace 100644 --- a/packages/apple-signin/README.md +++ b/packages/apple-signin/README.md @@ -305,6 +305,20 @@ if (Platform.OS === 'ios') { - **Credential State**: On iOS, you can check if the user's Apple ID is still authorized via `getCredentialState()`. This is used during token refresh instead of silent re-authentication. - **No Client-Side Refresh**: Apple does not support client-side token refresh. When the identity token expires, the user must re-authenticate. +## Platform Notes + +### Renewal & Maintenance + +- Apple Sign-In **keys do not automatically expire**. Once generated, they remain valid until they are revoked or deleted. +- Your Services ID is tied to your Apple Developer Program membership, which renews annually. If your membership lapses, Sign in with Apple stops working for all your apps. +- There are no certificates to rotate specifically for Sign in with Apple (unlike APNs push certificates). + +### iOS Version Notes + +- Sign in with Apple is available on Apple platforms starting with **iOS 13+**, but this library currently requires **iOS 15.1+** on iOS because its CocoaPods deployment target is set to 15.1. +- On **iOS 15+**, Apple provides more reliable support for detecting credential state changes (for example, revoked or transferred credentials) via `getCredentialState()`. +- On native, `AppleSignInButton` is a custom React Native button styled for Sign in with Apple; its appearance is defined by this package rather than by Apple's `ASAuthorizationAppleIDButton`. + ## API Reference ### Types