FirebaseExtended · tyler-reitz · Aug 6, 2026 · Aug 6, 2026
diff --git a/docs/reference/README.md b/docs/reference/README.md
diff --git a/docs/reference/functions/AuthCheck.md b/docs/reference/functions/AuthCheck.md
diff --git a/docs/reference/functions/ClaimsCheck.md b/docs/reference/functions/ClaimsCheck.md
diff --git a/docs/reference/functions/preloadUser.md b/docs/reference/functions/preloadUser.md
diff --git a/docs/reference/functions/useIdTokenResult.md b/docs/reference/functions/useIdTokenResult.md
diff --git a/docs/reference/functions/useSigninCheck.md b/docs/reference/functions/useSigninCheck.md
diff --git a/docs/reference/functions/useUser.md b/docs/reference/functions/useUser.md
diff --git a/docs/reference/interfaces/AuthCheckProps.md b/docs/reference/interfaces/AuthCheckProps.md
diff --git a/docs/reference/interfaces/ClaimCheckErrors.md b/docs/reference/interfaces/ClaimCheckErrors.md
diff --git a/docs/reference/interfaces/ClaimsCheckProps.md b/docs/reference/interfaces/ClaimsCheckProps.md
diff --git a/docs/reference/interfaces/ClaimsValidator.md b/docs/reference/interfaces/ClaimsValidator.md
diff --git a/docs/reference/interfaces/SignInCheckOptionsBasic.md b/docs/reference/interfaces/SignInCheckOptionsBasic.md
diff --git a/docs/reference/interfaces/SignInCheckOptionsClaimsObject.md b/docs/reference/interfaces/SignInCheckOptionsClaimsObject.md
diff --git a/docs/reference/interfaces/SignInCheckOptionsClaimsValidator.md b/docs/reference/interfaces/SignInCheckOptionsClaimsValidator.md
diff --git a/docs/reference/type-aliases/SigninCheckResult.md b/docs/reference/type-aliases/SigninCheckResult.md
diff --git a/docs/upgrade-guide.md b/docs/upgrade-guide.md
@@ -2,6 +2,32 @@
 
 ReactFire v5 contains breaking changes. This section lists them as they land; add an entry here in any PR that changes public behavior.
 
+## `AuthCheck` and `ClaimsCheck` removed
+
+Both components were deprecated in v4 (May 2021) in favor of the `useSigninCheck` hook, which shipped in the same release. They have been removed in v5.
+
+They only ever worked with `<FirebaseAppProvider suspense={true}>`, and in non-suspense mode they logged a deprecation warning and rendered anyway. If you used them without suspense, you have been seeing that warning.
+
+**If you use either component**, replace it with `useSigninCheck`:
+
+```tsx
+// Before
+<AuthCheck fallback={<SignInForm />} requiredClaims={{ admin: true }}>
+  <AdminPage />
+</AuthCheck>
+
+// After
+const { status, data: signInCheckResult } = useSigninCheck({ requiredClaims: { admin: true } });
+
+if (status === 'loading') return <LoadingSpinner />;
+
+return signInCheckResult.signedIn && signInCheckResult.hasRequiredClaims ? <AdminPage /> : <SignInForm />;
+```
+
+`useSigninCheck` also gives you the failed-claim details through `signInCheckResult.errors`, which the components never exposed, and it works in both suspense and non-suspense mode.
+
+The exported `AuthCheckProps` and `ClaimsCheckProps` types are gone with them. **`ClaimCheckErrors` remains**, since it is part of the `useSigninCheck` result shape.
+
 ## Error handling behavior change
 
 Previously, errors from any reactfire hook were thrown unconditionally, making `status: 'error'` unreachable in practice. In v5, error handling depends on the mode: