From 27bc2154d4d67a8a7388e6bd401d542d0dc56f6e Mon Sep 17 00:00:00 2001
From: wobsoriano <sorianorobertc@gmail.com>
Date: Sat, 27 Jun 2026 17:16:05 -0700
Subject: [PATCH] chore(expo): Mention config plugin in Google Sign-In
 migration notice

---
 .changeset/fresh-masks-warn-google-plugin.md                 | 5 +++++
 .../expo/src/hooks/__tests__/useSignInWithGoogle.test.ts     | 2 +-
 packages/expo/src/hooks/useSignInWithGoogle.android.ts       | 2 +-
 packages/expo/src/hooks/useSignInWithGoogle.ios.ts           | 2 +-
 packages/expo/src/hooks/useSignInWithGoogle.shared.ts        | 2 +-
 packages/expo/src/hooks/useSignInWithGoogle.ts               | 2 +-
 6 files changed, 10 insertions(+), 5 deletions(-)
 create mode 100644 .changeset/fresh-masks-warn-google-plugin.md

diff --git a/.changeset/fresh-masks-warn-google-plugin.md b/.changeset/fresh-masks-warn-google-plugin.md
new file mode 100644
index 00000000000..6a6e5c69a6f
--- /dev/null
+++ b/.changeset/fresh-masks-warn-google-plugin.md
@@ -0,0 +1,5 @@
+---
+"@clerk/expo": patch
+---
+
+Clarify the native Google Sign-In migration warning to mention the required Expo config plugin.
diff --git a/packages/expo/src/hooks/__tests__/useSignInWithGoogle.test.ts b/packages/expo/src/hooks/__tests__/useSignInWithGoogle.test.ts
index 7357d295f75..ec7d85e52dd 100644
--- a/packages/expo/src/hooks/__tests__/useSignInWithGoogle.test.ts
+++ b/packages/expo/src/hooks/__tests__/useSignInWithGoogle.test.ts
@@ -138,7 +138,7 @@ describe('useSignInWithGoogle', () => {
 
         expect(consoleWarnSpy).toHaveBeenCalledTimes(1);
         expect(consoleWarnSpy).toHaveBeenCalledWith(
-          'Clerk: In the next major version, native Google Sign-In will require installing @clerk/expo-google-signin. The @clerk/expo/google import path will continue to work.',
+          'Clerk: In the next major version, native Google Sign-In will require installing @clerk/expo-google-signin and adding its Expo config plugin. The @clerk/expo/google import path will continue to work.',
         );
       } finally {
         consoleWarnSpy.mockRestore();
diff --git a/packages/expo/src/hooks/useSignInWithGoogle.android.ts b/packages/expo/src/hooks/useSignInWithGoogle.android.ts
index 684e479aae2..3a2e343e71d 100644
--- a/packages/expo/src/hooks/useSignInWithGoogle.android.ts
+++ b/packages/expo/src/hooks/useSignInWithGoogle.android.ts
@@ -18,7 +18,7 @@ export type {
  * - No additional dependencies required
  *
  * In the next major version, apps using native Google Sign-In will need to install
- * `@clerk/expo-google-signin` alongside `@clerk/expo`.
+ * `@clerk/expo-google-signin` alongside `@clerk/expo` and add its Expo config plugin.
  *
  * @example
  * ```tsx
diff --git a/packages/expo/src/hooks/useSignInWithGoogle.ios.ts b/packages/expo/src/hooks/useSignInWithGoogle.ios.ts
index 936054c6389..fdd7541bf01 100644
--- a/packages/expo/src/hooks/useSignInWithGoogle.ios.ts
+++ b/packages/expo/src/hooks/useSignInWithGoogle.ios.ts
@@ -18,7 +18,7 @@ export type {
  * - No additional dependencies required
  *
  * In the next major version, apps using native Google Sign-In will need to install
- * `@clerk/expo-google-signin` alongside `@clerk/expo`.
+ * `@clerk/expo-google-signin` alongside `@clerk/expo` and add its Expo config plugin.
  *
  * @example
  * ```tsx
diff --git a/packages/expo/src/hooks/useSignInWithGoogle.shared.ts b/packages/expo/src/hooks/useSignInWithGoogle.shared.ts
index b01b8f2c6e8..68d80f53129 100644
--- a/packages/expo/src/hooks/useSignInWithGoogle.shared.ts
+++ b/packages/expo/src/hooks/useSignInWithGoogle.shared.ts
@@ -33,7 +33,7 @@ function warnAboutGoogleSignInPackageMigration() {
 
   hasWarnedAboutGoogleSignInPackage = true;
   console.warn(
-    'Clerk: In the next major version, native Google Sign-In will require installing @clerk/expo-google-signin. The @clerk/expo/google import path will continue to work.',
+    'Clerk: In the next major version, native Google Sign-In will require installing @clerk/expo-google-signin and adding its Expo config plugin. The @clerk/expo/google import path will continue to work.',
   );
 }
 
diff --git a/packages/expo/src/hooks/useSignInWithGoogle.ts b/packages/expo/src/hooks/useSignInWithGoogle.ts
index 15322170ed5..cc6b07356dd 100644
--- a/packages/expo/src/hooks/useSignInWithGoogle.ts
+++ b/packages/expo/src/hooks/useSignInWithGoogle.ts
@@ -22,7 +22,7 @@ export type StartGoogleAuthenticationFlowReturnType = {
  * For web platforms, use the OAuth-based Google Sign-In flow instead via useSSO.
  *
  * In the next major version, apps using native Google Sign-In will need to install
- * `@clerk/expo-google-signin` alongside `@clerk/expo`.
+ * `@clerk/expo-google-signin` alongside `@clerk/expo` and add its Expo config plugin.
  *
  * @example
  * ```tsx