From 73e8a3ba833d55c969659b4f721b63028208b334 Mon Sep 17 00:00:00 2001
From: Ademola Fadumo <48495111+demolaf@users.noreply.github.com>
Date: Wed, 28 Oct 2026 13:49:59 +0100
Subject: [PATCH 1/2] docs(auth): point the theming section at the slot APIs

---
 auth/README.md | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/auth/README.md b/auth/README.md
index 613569d90..250c89e01 100644
--- a/auth/README.md
+++ b/auth/README.md
@@ -62,6 +62,7 @@ Equivalent FirebaseUI libraries are available for [iOS](https://github.com/fireb
    - [Creating a Completely Custom Theme](#creating-a-completely-custom-theme)
    - [Provider Button Styling](#provider-button-styling)
    - [Screen Transitions](#screen-transitions)
+   - [Beyond Theming](#beyond-theming)
 
 ### Advanced
 9. [Advanced Features](#advanced-features)
@@ -1303,7 +1304,7 @@ fun ManualMfaChallenge(resolver: MultiFactorResolver) {
 FirebaseUI Auth provides flexible theming options to match your app's design:
 
 - **`AuthUITheme.Default`** / **`AuthUITheme.DefaultDark`** / **`AuthUITheme.Adaptive`** - Pre-configured Material Design 3 themes
-- **`.copy()`** - Customize specific properties of the default themes (data class)
+- **`.copy()`** - Customize specific properties of the default themes
 - **`fromMaterialTheme()`** - Inherit from your app's existing Material Theme
 - **Custom theme** - Full control over colors, typography, shapes, and provider button styles
 
@@ -1867,6 +1868,18 @@ val configuration = authUIConfiguration {
 > (`NavigationEvent.EDGE_LEFT`, `EDGE_RIGHT` or `EDGE_NONE`) and runs when the gesture *starts*,
 > so a side effect placed in it fires even for gestures the user goes on to cancel.
 
+### Beyond Theming
+
+`AuthUITheme` restyles the built-in screens but keeps their layout. To replace a screen's layout
+entirely, use the `FirebaseAuthScreen` slot parameters described in
+[Custom UI with Slots](#custom-ui-with-slots). They swap in your own composables while FirebaseUI
+keeps the authentication logic.
+
+The demo app's
+[`fullcustomization`](../app/src/main/java/com/firebaseui/android/demo/auth/fullcustomization/FullCustomizationDemoActivity.kt)
+sample uses both: an `AuthUITheme.Default.copy(...)` theme, plus custom UI for every slot, from the
+method picker through MFA and reauthentication to the signed-in screen.
+
 ## Advanced Features
 
 ### Anonymous User Upgrade

From 5f3aeebec6b3811465adb47c41974b16cb609488 Mon Sep 17 00:00:00 2001
From: Ademola Fadumo <48495111+demolaf@users.noreply.github.com>
Date: Wed, 28 Oct 2026 14:03:50 +0100
Subject: [PATCH 2/2] docs(auth): tighten the beyond theming wording and link

---
 auth/README.md | 12 +++---------
 1 file changed, 3 insertions(+), 9 deletions(-)

diff --git a/auth/README.md b/auth/README.md
index 250c89e01..1ab1f9627 100644
--- a/auth/README.md
+++ b/auth/README.md
@@ -1870,15 +1870,9 @@ val configuration = authUIConfiguration {
 
 ### Beyond Theming
 
-`AuthUITheme` restyles the built-in screens but keeps their layout. To replace a screen's layout
-entirely, use the `FirebaseAuthScreen` slot parameters described in
-[Custom UI with Slots](#custom-ui-with-slots). They swap in your own composables while FirebaseUI
-keeps the authentication logic.
-
-The demo app's
-[`fullcustomization`](../app/src/main/java/com/firebaseui/android/demo/auth/fullcustomization/FullCustomizationDemoActivity.kt)
-sample uses both: an `AuthUITheme.Default.copy(...)` theme, plus custom UI for every slot, from the
-method picker through MFA and reauthentication to the signed-in screen.
+`AuthUITheme` restyles the built-in screens but keeps their layout. To replace a screen's layout entirely, use the `FirebaseAuthScreen` slot parameters described in [Custom UI with Slots](#custom-ui-with-slots). They swap in your own composables while FirebaseUI keeps the authentication logic.
+
+The demo app's [`fullcustomization`](../app/src/main/java/com/firebaseui/android/demo/auth/fullcustomization/) sample uses both: an `AuthUITheme.Default.copy(...)` theme, plus custom UI for every screen slot, from the method picker through MFA and reauthentication to the signed-in screen.
 
 ## Advanced Features