fix(react): conditionally load UI scripts to prevent document.createE… (#7769)

chriscanin · jacekradko · web-flow · commit 1a7cac1eb48e · 2026-02-27T13:38:14.000-06:00
Co-authored-by: Jacek &lt;jacek@clerk.dev&gt;
diff --git a/.changeset/modern-hornets-fold.md b/.changeset/modern-hornets-fold.md
@@ -0,0 +1,5 @@
+---
+"@clerk/react": patch
+---
+
+Fix `ReferenceError: Property 'document' doesn't exist` crash in React Native environments by conditionally loading UI scripts only in standard browser contexts.
diff --git a/packages/react/src/isomorphicClerk.ts b/packages/react/src/isomorphicClerk.ts
@@ -468,11 +468,13 @@ export class IsomorphicClerk implements IsomorphicLoadedClerk {
     }
 
     try {
-      const ClerkUI = await this.getClerkUIEntryChunk();
       const clerk = await this.getClerkJsEntryChunk();
 
       if (!clerk.loaded) {
         this.beforeLoad(clerk);
+        // Only load UI scripts in standard browser environments (not native/headless)
+        const shouldLoadUi = !this.options.Clerk && this.options.standardBrowser !== false;
+        const ClerkUI = shouldLoadUi ? await this.getClerkUIEntryChunk() : undefined;
         await clerk.load({ ...this.options, ui: { ...this.options.ui, ClerkUI } });
       }
       if (clerk.loaded) {

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"@clerk/react": patch
 +---
++
 +Fix `ReferenceError: Property 'document' doesn't exist` crash in React Native environments by conditionally loading UI scripts only in standard browser contexts.
Original file line number	Diff line number	Diff line change
`@@ -468,11 +468,13 @@ export class IsomorphicClerk implements IsomorphicLoadedClerk {`
`468`	`468`	`}`
`469`	`469`
`470`	`470`	`try {`
`471`		`- const ClerkUI = await this.getClerkUIEntryChunk();`
`472`	`471`	`const clerk = await this.getClerkJsEntryChunk();`
`473`	`472`
`474`	`473`	`if (!clerk.loaded) {`
`475`	`474`	`this.beforeLoad(clerk);`
	`475`	`+ // Only load UI scripts in standard browser environments (not native/headless)`
	`476`	`+ const shouldLoadUi = !this.options.Clerk && this.options.standardBrowser !== false;`
	`477`	`+ const ClerkUI = shouldLoadUi ? await this.getClerkUIEntryChunk() : undefined;`
`476`	`478`	`await clerk.load({ ...this.options, ui: { ...this.options.ui, ClerkUI } });`
`477`	`479`	`}`
`478`	`480`	`if (clerk.loaded) {`