Skip to content

docs(auth): point the theming section at the slot APIs #2543

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
demolaf wants to merge 2 commits into
base: master
Choose a base branch
from
Open

docs(auth): point the theming section at the slot APIs #2543

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
73e8a3b
docs(auth): point the theming section at the slot APIs
demolaf Oct 28, 2026
5f3aeeb
docs(auth): tighten the beyond theming wording and link
demolaf Oct 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion auth/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -1867,6 +1868,12 @@ 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/) 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

### Anonymous User Upgrade
Expand Down
Loading