From 220d476b201198fe6eabe2991436d243f850f284 Mon Sep 17 00:00:00 2001 From: ChrisCanin Date: Wed, 18 Mar 2026 09:27:23 -0700 Subject: [PATCH 1/4] docs(expo): document @clerk/expo config plugin options (appleSignIn, keychainService) --- .../expo/native-components/overview.mdx | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/reference/expo/native-components/overview.mdx b/docs/reference/expo/native-components/overview.mdx index 5fab924f0b..7c9baa671b 100644 --- a/docs/reference/expo/native-components/overview.mdx +++ b/docs/reference/expo/native-components/overview.mdx @@ -34,6 +34,31 @@ Native components require: } ``` + The plugin accepts the following options: + + | Option | Type | Default | Description | + | - | - | - | - | + | `appleSignIn` | `boolean` | `true` | Whether to add the `com.apple.developer.applesignin` entitlement. Set to `false` if your app does not use Apple Sign In. | + | `keychainService` | `string` | — | Custom keychain service identifier. Required if you need extension targets (widgets, App Clips, Watch) to share the keychain with the main app. | + + Example with options: + + ```json {{ filename: 'app.json' }} + { + "expo": { + "plugins": [ + [ + "@clerk/expo", + { + "appleSignIn": false, + "keychainService": "com.example.myapp" + } + ] + ] + } + } + ``` + - If using social connections, you must register your native application credentials in the Clerk Dashboard. See the [Sign in with Google](/docs/guides/configure/auth-strategies/sign-in-with-google) and [Sign in with Apple](/docs/guides/configure/auth-strategies/sign-in-with-apple) guides for setup steps. ## How it works From 0d30cf68153791776527fff16932ed43233e5e79 Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Wed, 18 Mar 2026 14:28:52 -0600 Subject: [PATCH 2/4] docs review --- .../expo/native-components/overview.mdx | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/docs/reference/expo/native-components/overview.mdx b/docs/reference/expo/native-components/overview.mdx index 7c9baa671b..d8a52304cd 100644 --- a/docs/reference/expo/native-components/overview.mdx +++ b/docs/reference/expo/native-components/overview.mdx @@ -36,10 +36,19 @@ Native components require: The plugin accepts the following options: - | Option | Type | Default | Description | - | - | - | - | - | - | `appleSignIn` | `boolean` | `true` | Whether to add the `com.apple.developer.applesignin` entitlement. Set to `false` if your app does not use Apple Sign In. | - | `keychainService` | `string` | — | Custom keychain service identifier. Required if you need extension targets (widgets, App Clips, Watch) to share the keychain with the main app. | + + - `appleSignIn` + - `boolean` + + Whether to add the `com.apple.developer.applesignin` entitlement. Set to `false` if your app does not use Apple Sign In. Defaults to `true`. + + --- + + - `keychainService` + - `string` + + Custom keychain service identifier. Required if you need extension targets (widgets, App Clips, Watch) to share the keychain with the main app. + Example with options: From ec9330a71a8184fd4d4f8f74dd41c32fc6d545fb Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Wed, 18 Mar 2026 14:34:22 -0600 Subject: [PATCH 3/4] Fix layout --- .../expo/native-components/overview.mdx | 48 +++++++++---------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/reference/expo/native-components/overview.mdx b/docs/reference/expo/native-components/overview.mdx index d8a52304cd..6aa930278a 100644 --- a/docs/reference/expo/native-components/overview.mdx +++ b/docs/reference/expo/native-components/overview.mdx @@ -34,39 +34,39 @@ Native components require: } ``` - The plugin accepts the following options: +The plugin accepts the following options: - - - `appleSignIn` - - `boolean` + + - `appleSignIn` + - `boolean` - Whether to add the `com.apple.developer.applesignin` entitlement. Set to `false` if your app does not use Apple Sign In. Defaults to `true`. + Whether to add the `com.apple.developer.applesignin` entitlement. Set to `false` if your app does not use Apple Sign In. Defaults to `true`. - --- + --- - - `keychainService` - - `string` + - `keychainService` + - `string` - Custom keychain service identifier. Required if you need extension targets (widgets, App Clips, Watch) to share the keychain with the main app. - + Custom keychain service identifier. Required if you need extension targets (widgets, App Clips, Watch) to share the keychain with the main app. + - Example with options: +Example with options: - ```json {{ filename: 'app.json' }} - { - "expo": { - "plugins": [ - [ - "@clerk/expo", - { - "appleSignIn": false, - "keychainService": "com.example.myapp" - } - ] +```json {{ filename: 'app.json' }} +{ + "expo": { + "plugins": [ + [ + "@clerk/expo", + { + "appleSignIn": false, + "keychainService": "com.example.myapp" + } ] - } + ] } - ``` +} +``` - If using social connections, you must register your native application credentials in the Clerk Dashboard. See the [Sign in with Google](/docs/guides/configure/auth-strategies/sign-in-with-google) and [Sign in with Apple](/docs/guides/configure/auth-strategies/sign-in-with-apple) guides for setup steps. From b1d7ab71824da4316264cc914c3bbb38aa7d57b0 Mon Sep 17 00:00:00 2001 From: Sarah Soutoul Date: Wed, 18 Mar 2026 14:42:55 -0600 Subject: [PATCH 4/4] Change layout for better presentationg --- docs/reference/expo/native-components/overview.mdx | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/reference/expo/native-components/overview.mdx b/docs/reference/expo/native-components/overview.mdx index 6aa930278a..929a16611d 100644 --- a/docs/reference/expo/native-components/overview.mdx +++ b/docs/reference/expo/native-components/overview.mdx @@ -24,7 +24,7 @@ Native components require: - A [development build](https://docs.expo.dev/develop/development-builds/introduction/) (`npx expo run:ios` or `npx expo run:android`), as these components are not available in Expo Go. -- The `@clerk/expo` plugin configured in your `app.json` file: +- The `@clerk/expo` plugin configured in your `app.json` file. See the [available plugin options](#expo-plugin-options). ```json {{ filename: 'app.json' }} { @@ -34,6 +34,10 @@ Native components require: } ``` +- If using social connections, you must register your native application credentials in the Clerk Dashboard. See the [Sign in with Google](/docs/guides/configure/auth-strategies/sign-in-with-google) and [Sign in with Apple](/docs/guides/configure/auth-strategies/sign-in-with-apple) guides for setup steps. + +### Expo plugin options + The plugin accepts the following options: @@ -50,7 +54,7 @@ The plugin accepts the following options: Custom keychain service identifier. Required if you need extension targets (widgets, App Clips, Watch) to share the keychain with the main app. -Example with options: +#### Example ```json {{ filename: 'app.json' }} { @@ -68,8 +72,6 @@ Example with options: } ``` -- If using social connections, you must register your native application credentials in the Clerk Dashboard. See the [Sign in with Google](/docs/guides/configure/auth-strategies/sign-in-with-google) and [Sign in with Apple](/docs/guides/configure/auth-strategies/sign-in-with-apple) guides for setup steps. - ## How it works The native components handle authentication through the native Clerk SDKs ([clerk-ios](https://github.com/clerk/clerk-ios) and [clerk-android](https://github.com/clerk/clerk-android)). When authentication completes, the session is automatically synchronized to the JavaScript SDK: