Skip to content

feat : Add Partial Custom Tabs support (bottom sheet & side sheet)#954

Merged
subhankarmaiti merged 5 commits intomainfrom
feat/partial-custom-tabs
Apr 17, 2026
Merged

feat : Add Partial Custom Tabs support (bottom sheet & side sheet)#954
subhankarmaiti merged 5 commits intomainfrom
feat/partial-custom-tabs

Conversation

@subhankarmaiti
Copy link
Copy Markdown
Contributor

Adds support for Partial Custom Tabs, allowing the browser-based authentication flow to render as a bottom sheet or side sheet instead of taking over the full screen. Requires Chrome 107+; gracefully falls back to full-screen Custom Tabs on unsupported browsers.

API Changes

Six new methods on CustomTabsOptions.Builder:

Method Description
withInitialHeight(int height) Sets the bottom sheet height in dp. Minimum enforced by Chrome is 50% of screen.
withInitialWidth(int width) Sets the side sheet width in dp (for wider screens).
withResizable(boolean resizable) Locks or unlocks user-resizing of the sheet. Default: resizable.
withToolbarCornerRadius(int cornerRadius) Sets toolbar top corner radius in dp. Only applies in bottom sheet mode.
withSideSheetBreakpoint(int breakpoint) Breakpoint in dp to toggle between bottom sheet and side sheet. Browser default is typically 840dp.
withBackgroundInteractionEnabled(boolean enabled) Allows tapping the background app while the partial tab is visible. Default: disabled.

All dimension parameters accept dp values. Height and width are converted to pixels internally via dpToPx().

Usage — Bottom Sheet

CustomTabsOptions options = CustomTabsOptions.newBuilder()
    .withInitialHeight(500)
    .withToolbarCornerRadius(16)
    .withResizable(false)
    .build();

WebAuthProvider.login(account)
    .withCustomTabsOptions(options)
    .start(context, callback);

Usage — Side Sheet on larger screens

CustomTabsOptions options = CustomTabsOptions.newBuilder()
    .withInitialHeight(500)
    .withInitialWidth(400)
    .withSideSheetBreakpoint(800)
    .withToolbarCornerRadius(10)
    .withResizable(false)
    .build();

WebAuthProvider.login(account)
    .withCustomTabsOptions(options)
    .start(context, callback);

@subhankarmaiti subhankarmaiti requested a review from a team as a code owner April 16, 2026 18:23
@pmathew92 pmathew92 changed the title Add Partial Custom Tabs support (bottom sheet & side sheet) feat : Add Partial Custom Tabs support (bottom sheet & side sheet) Apr 17, 2026
Comment thread auth0/src/main/java/com/auth0/android/provider/CustomTabsOptions.java Outdated
@subhankarmaiti subhankarmaiti merged commit 91dcd63 into main Apr 17, 2026
6 checks passed
@subhankarmaiti subhankarmaiti deleted the feat/partial-custom-tabs branch April 17, 2026 11:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants