fix(clerk-js): Handle missing window.location in React Native navigation (#7854)

Author: SarahSoutoul

.changeset/sixty-gifts-stand.md

@@ -0,0 +1,5 @@
+---
+'@clerk/clerk-js': patch
+---
+
+fix(clerk-js): Handle missing window.location in React Native navigation

packages/clerk-js/src/core/clerk.ts

@@ -1666,6 +1666,27 @@ export class Clerk implements ClerkInterface {
       return;
     }
 
+    // In React Native, window exists but window.location does not.
+    // If we have a custom router, use it directly. Otherwise, return early.
+    if (typeof window.location === 'undefined') {
+      const customNavigate =
+        options?.replace && this.#options.routerReplace ? this.#options.routerReplace : this.#options.routerPush;
+
+      if (customNavigate) {
+        debugLogger.info(`Clerk is navigating to: ${to}`);
+        return await customNavigate(to, { windowNavigate });
+      }
+
+      // No window.location and no custom router - can't navigate
+      if (__DEV__) {
+        console.warn(
+          'Clerk: Navigation was attempted but window.location is not available and no custom router (routerPush/routerReplace) was provided. ' +
+            'If you are using React Native, please provide routerPush and routerReplace options to ClerkProvider.',
+        );
+      }
+      return;
+    }
+
     /**
      * Trigger all navigation listeners. In order for modal UI components to close.
      */

packages/react/src/hooks/useSignUp.ts

@@ -6,7 +6,7 @@ import { useIsomorphicClerkContext } from '../contexts/IsomorphicClerkContext';
 import { useAssertWrappedByClerkProvider } from './useAssertWrappedByClerkProvider';
 
 /**
- * The `useSignUp()` hook provides access to the [`SignUp`](https://clerk.com/docs/reference/javascript/sign-up) object, which allows you to check the current state of a sign-up attempt and manage the sign-up flow. You can use this to create a [custom sign-up flow](!custom-flow)
+ * The `useSignUp()` hook provides access to the [`SignUp`](https://clerk.com/docs/reference/javascript/sign-up) object, which allows you to check the current state of a sign-up attempt and manage the sign-up flow. You can use this to create a [custom sign-up flow](!custom-flow).
  *
  * @unionReturnHeadings
  * ["Initialization", "Loaded"]