Compose Material 3 Adaptive

  
Use the Material 3 adaptive library to create adaptive UIs that will adapt themselves automatically according to the current window configurations like window size classes or device postures. The library provides both default scaffold implementations and necessary building block composables to create your own custom experiences.
Latest Update Stable Release Release Candidate Beta Release Alpha Release
October 22, 2025 1.2.0 - - 1.3.0-alpha02

Declaring dependencies

To add a dependency on compose, you must add the Google Maven repository to your project. Read Google's Maven repository for more information.

Add the dependencies for the artifacts you need in the build.gradle file for your app or module:

Groovy

dependencies {
    implementation "androidx.compose.material3.adaptive:adaptive:1.3.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.3.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.3.0-alpha02"
}

Kotlin

dependencies {
    implementation("androidx.compose.material3.adaptive:adaptive:1.3.0-alpha02")
    implementation("androidx.compose.material3.adaptive:adaptive-layout:1.3.0-alpha02")
    implementation("androidx.compose.material3.adaptive:adaptive-navigation:1.3.0-alpha02")
}

For more information about dependencies, see Add build dependencies.

Feedback

Your feedback helps make Jetpack better. Let us know if you discover new issues or have ideas for improving this library. Please take a look at the existing issues in this library before you create a new one. You can add your vote to an existing issue by clicking the star button.

Create a new issue

See the Issue Tracker documentation for more information.

Compose Material3 Adaptive Navigation3 Version 1.0

September 24, 2025

androidx.compose.material3.adaptive:adaptive-navigation3:1.0.0-alpha03 is released. Version 1.0.0-alpha03 contains these commits.

API Changes

  • Add KMP stubs so JetBrains can fork and fill these targets to enable CMP. (I75714)
  • Move adaptive-navigation3 to commonMain to enable multiplatform use. (I58aa9)

September 10, 2025

androidx.compose.material3.adaptive:adaptive-navigation3:1.0.0-alpha02 and androidx.compose.material3.adaptive:adaptive-navigation3-android:1.0.0-alpha02 are released. Version 1.0.0-alpha02 contains these commits.

August 27, 2025

androidx.compose.material3.adaptive:adaptive-navigation3:1.0.0-alpha01 and androidx.compose.material3.adaptive:adaptive-navigation3-android:1.0.0-alpha01 are released. Version 1.0.0-alpha01 contains these commits.

New Features

We are excited to announce the first alpha release of the adaptive-navigation3 library. This new library, part of the Material Adaptive and Navigation3 ecosystem, is designed to help you build adaptive Material UIs integrated with the Navigation3 library.

Use scene strategies to implement a canonical list-detail pane scaffold (ListDetailSceneStrategy, rememberListDetailSceneStrategy) or a supporting pane scaffold (SupportingPaneSceneStrategy, rememberSupportingPaneSceneStrategy). For more information about scenes, scene strategies, and other new concepts introduced in Navigation 3, refer to the Navigation3 guide.

Compose Material3 Adaptive Version 1.3

Version 1.3.0-alpha02

October 22, 2025

androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha02 is released. Version 1.3.0-alpha02 contains these commits.

API Changes

  • Material adaptive scene strategies now allow passing custom pane adapt strategies (Iae61d, b/437981298)
  • Graduate pane scaffold horizontal order APIs to stable (I23ab3)
  • Introduce DragToResizeState to Levitate strategy (I717bd)
  • Deprecate window size APIs (I6749e, b/424442112)

Version 1.3.0-alpha01

October 08, 2025

androidx.compose.material3.adaptive:adaptive-*:1.3.0-alpha01 is released. Version 1.3.0-alpha01 contains these commits.

New Features

  • ListDetailPaneScaffold and SupportingPaneScaffold are now supporting margins and edge-to-edge.
  • The adaptive-navigation3 integration library is being released as 1.3.0-alpha01 since this version (previously 1.0.0-alpha03).

API Changes

  • Introduce pane margin and edge-to-edge support to ThreePaneScaffold. (If0794, b/333539848)

Compose Material3 Adaptive Version 1.2

Version 1.2.0

October 22, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0 is released. Version 1.2.0 contains these commits.

Important changes since 1.1.0:

  • Introduce PaneScaffoldScope.preferredHeight modifier for devs to provide pane preferred heights that will be applied with new adapt strategies we are going to introduce. (I957dd)
  • Add saveable state holder to PaneScaffoldScope (Id9299)
  • Introduce reflow strategy for adaptation (I75c6a)
  • Introduce levitate strategy for adaptation (I1ba7c)
  • Make currentWindowAdaptiveInfo() function support large and extra-large window width size classes (I92e97)
  • Support custom dragging behavior with pane expansion state (If5c61)

Version 1.2.0-rc01

October 08, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-rc01 is released. Version 1.2.0-rc01 contains these commits.

Bug Fixes

Version 1.2.0-beta03

September 24, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-beta03 is released. Version 1.2.0-beta03 contains these commits.

Bug Fixes

  • Fix incorrect re-anchoring during dragging. (6453cb6)

Version 1.2.0-beta02

September 10, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-beta02 is released. Version 1.2.0-beta02 contains these commits.

API Changes

Bug Fixes

  • Use new initial anchor when pane expansion anchor list changes (I91cd1, b/438829477)

Version 1.2.0-beta01

August 27, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-beta01 is released. Version 1.2.0-beta01 contains these commits.

New Features

  • Support alternative input methods for the drag-to-resize feature (Id7796)

API Changes

  • Support custom dragging behavior with pane expansion state (If5c61)
  • Adds an indicator in the pane scope interface to denote if a pane should be interactable or not. Also uses this indicator to disable accessibility access for underlying panes when a levitated pane is shown with a scrim. (If36f3)
  • Replace Scrim definition with composable lambdas (I7d811)
  • Mark window size and posture related APIs as experimental (I4ee96)
  • Expose PaneScaffoldHorizontalOrder as a sealed public API (Ia4ebe)

Bug Fixes

  • Workaround the crash caused by unnecessary approaching measure (I0a65a, b/418932957)

Version 1.2.0-alpha11

August 13, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha11 is released. Version 1.2.0-alpha11 contains these commits.

API Changes

  • Introduce a generic PaneScaffoldRole interface to improve API readability (I1b757)
  • Remove AdaptStrategy.Levitated.Strategy class (I6f798)
  • Changes Modifier.preferredWidth/Height's proportion parameter from Int percentage values to Float ranges from 0 to 1. (Ib2de2)

Bug Fixes

Version 1.2.0-alpha10

July 30, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha10 is released. Version 1.2.0-alpha10 contains these commits.

API Changes

  • Support preferred width/height represented in proportions. (I63dda)
  • Hides Reflow and Levitate strategies' constructor parameters; also renames targetPane to reflowUnder. (Ifa81b)

Bug Fixes

  • Fix performance regression caused by snapshoting the scaffold state transition progress (I3d555, b/417329258)

Version 1.2.0-alpha09

July 16, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha09 is released. Version 1.2.0-alpha09 contains these commits.

Version 1.2.0-alpha08

July 2, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha08 is released. Version 1.2.0-alpha08 contains these commits.

Version 1.2.0-alpha07

June 18, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha07 is released. Version 1.2.0-alpha07 contains these commits.

API Changes

  • Make currentWindowAdaptiveInfo() function support large and extra-large window width size classes and promote calculatePosture() and currentWindowDpSize() functions to stable. (I92e97)

Version 1.2.0-alpha06

May 20, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha06 is released. Version 1.2.0-alpha06 contains these commits.

New Features

  • The default pane scaffold directive calculation functions is now supporting L and XL window width size classes.

API Changes

  • Make Modifier.paneExpansionDraggable provide default accessibility semantics and promote relevant APIs to stable. (Idb818)
  • Support drag-to-resize with levitated panes (Idadd3)
  • Support scrims for levitated panes (I9b091)

Version 1.2.0-alpha05

May 7, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha05 is released. Version 1.2.0-alpha05 contains these commits.

New Features

  • Material3 adaptive layouts are now supporting Levitated adapt strategies that can turn a pane into a floating popup.

API Changes

  • Make current window size functions support multi-platform (Ie4172)
  • Introduce pane motions for levitated panes (Ic9dc3)
  • Introduce levitate strategy for adaptation (I1ba7c)

Bug Fixes

  • Fix the usage of coroutine scope in adaptive samples (7631016)

Version 1.2.0-alpha04

April 23, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha04 is released. Version 1.2.0-alpha04 contains these commits.

New Features

  • Reflow strategies are now available with ListDetailPaneScaffold and SupportingPaneScaffold, which reflows the associated pane under a single-pane layout setting.

API Changes

  • Add saveable state holder to PaneScaffoldScope (Id9299)
  • Introduce reflow strategy for adaptation (I75c6a)

Bug Fixes

  • Fix the bug that panes not animate in the first transition. (Ib0415)
  • Fix preferred heights not working. (I1913b)
  • Fix the bug that scaffold directive is not correctly updated. (0403ab)

Version 1.2.0-alpha03

April 9, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha03 is released. Version 1.2.0-alpha03 contains these commits.

Bug Fixes

  • ​​Fix drag handle incorrectly showing on single pane layout. (806e443 )

Dependency Updates

  • This library now targets Kotlin 2.0 language level and requires KGP 2.0.0 or newer. (Idb6b5)

Version 1.2.0-alpha02

March 26, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha02 is released. Version 1.2.0-alpha02 contains these commits.

Version 1.2.0-alpha01

March 12, 2025

androidx.compose.material3.adaptive:adaptive-*:1.2.0-alpha01 is released. Version 1.2.0-alpha01 contains these commits.

API Changes

  • Introduce PaneScaffoldScope.preferredHeight modifier for devs to provide pane preferred heights that will be applied with new adapt strategies we are going to introduce. (I957dd, b/220960090)
  • Rename ComponentOverride types to Override, and ComponentOverrideContext types to OverrideScope. (Id973c)
  • Rename some component override methods. (I222b3)

Compose Material3 Adaptive Version 1.1

Version 1.1.0

March 12, 2025

androidx.compose.material3.adaptive:adaptive-*:1.1.0 is released. Version 1.1.0 contains these commits.

Important changes since 1.0.0

Version 1.1.0-rc01

February 26, 2025

androidx.compose.material3.adaptive:adaptive-*:1.1.0-rc01 is released. Version 1.1.0-rc01 contains these commits.

Bug Fixes

  • Disable three pane scaffold predictive back scale (ab6fd0b)

Version 1.1.0-beta02

February 12, 2025

androidx.compose.material3.adaptive:adaptive-*:1.1.0-beta02 is released. Version 1.1.0-beta02 contains these commits.

API Changes

  • Changed how isPredictiveBackInProgress is set in MutableThreePaneScaffoldState animation functions to preserve state consistency. (Idc97f)

Bug Fixes

  • The default back behavior of NavigableListDetailPaneScaffold and NavigableSupportingPaneScaffold has been changed to PopUntilScaffoldValueChange for consistency with the rest of the library. (I873f0)
  • Set the correct accessibility traversing order of pane scaffolds. (67d030)
  • Fix the issue that pane content states are not saved. (88b0ff)
  • Support alternative accessibility actions in place of dragging. (28266d)
  • Announce the current pane split after it's changed. (0c3a80)

Version 1.1.0-beta01

January 29, 2025

androidx.compose.material3.adaptive:adaptive-*:1.1.0-beta01 is released. Version 1.1.0-beta01 contains these commits.

API Changes

  • Introduce factory functions to create pane expansion anchors of the offset type from the start and the end, respectively. (I2eb21)
  • Seal PaneMotion interface and remove its default transition methods. (Ifc4c7)
  • Introduce APIs to get the current anchor and animate to an anchor. (Icf95d)
  • Introduce accessibility APIs for pane expansion (Icc669)
  • Change PaneScaffoldParentData.preferredWidth's type to DP. (Id98ee)

Version 1.1.0-alpha09

January 15, 2025

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha09 is released. Version 1.1.0-alpha09 contains these commits.

API Changes

  • Add and use new experimental annotation ExperimentalMaterial3AdaptiveComponentOverrideApi. (Id45aa)
  • Hide ThreePaneScaffoldHorizontalOrder.toLtrOrder. (I6f8d2)
  • ThreePaneScaffoldPredictiveBackHandler has been made public. (I1a995, b/370543873)
  • Added isPredictiveBackInProgress property to ThreePaneScaffoldState. (I1a995, b/370543873)
  • Create overriding mechanism for AnimatedPane to support sideloading implementations for different form factors. (Id7622)

Bug Fixes

  • Fix the issue when the settling direction has no anchors. (df8257d)

Version 1.1.0-alpha08

December 12, 2024

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha08 is released. Version 1.1.0-alpha08 contains these commits.

API Changes

  • Introduce currentWindowDpSize function. (I99125, b/296300441)
  • Expose PaneScaffoldParentData and ThreePaneScaffoldHorizontalOrder.toLtrOrder() (I2d6b7)
  • Remove PaneScaffoldMotionScope and turn it into a field under PaneScaffoldTransitionScope. Also rename it to PaneScaffoldMotionDataProvider and remove the access to the underlying data structure of PaneMotionData - instead, provide getter and looping methods for accessing the data. (Id8884)
  • Create overriding mechanism for ThreePaneScaffold to support sideloading implementations for different form factors. (I5280f)
  • Makes pane expansion state null by default (Ia65f8, b/376394520)

Version 1.1.0-alpha07

November 13, 2024

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha07 is released. Version 1.1.0-alpha07 contains these commits.

API Changes

  • Remove drag handle implementation in the adaptive library and encourage people to use the M3 version of it. And at the same time introduce a modifier to provide pane expansion dragging ability to a provided drag handle composable. Also hide DraggableState as an implementation detail so we can change it later if needed. (Ib50cd)
  • Moves the entry point of pane motion customization from the scaffold functions to AnimatedPane according to UXR feedback. (I10f72)
  • Introduce fling support and custom animation spec for pane expansion. (Ie207d, b/362584341)

Bug Fixes

Version 1.1.0-alpha06

October 30, 2024

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha06 is released. Version 1.1.0-alpha06 contains these commits.

API Changes

  • Add FloatRange to PaneScaffoldTransitionScope.motionProgress. (Iac0dd)
  • Change navigator params' type to generic types in navigable scaffolds. (I1da6e)

Version 1.1.0-alpha05

October 16, 2024

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha05 is released. Version 1.1.0-alpha05 contains these commits.

API Changes

  • Introduce animation specs class to ensure more consistent motion behavior and future expandability. (I2d3cc)
  • Provide motion type and rename currentXXXXX in PaneMotionData to originXXXX. (I7c61a)

Version 1.1.0-alpha04

October 2, 2024

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha04 is released. Version 1.1.0-alpha04 contains these commits.

New Features

  • Added predictive back support to NavigableListDetailPaneScaffold and NavigableSupportingPaneScaffold. (I4dc21, b/359616816)

API Changes

  • Added ThreePaneScaffoldState to ThreePaneScaffoldNavigator. Navigation methods have been made suspend to support navigation with animation. Added seekBack to support partial navigation states (e.g. predictive back). (I5a651, b/359616816)
  • Added MutableThreePaneScaffoldState to control the transition between scaffold values. The existing ThreePaneScaffoldState has been made read-only. (Idb3c6)
  • Expose default pane motion implementations (I95a7b)
  • Enable setting initial anchor of pane expansion state (Ie41b3, b/362350560)

Bug Fixes

Version 1.1.0-alpha03

September 18, 2024

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha03 is released. Version 1.1.0-alpha03 contains these commits.

Version 1.1.0-alpha02

September 4, 2024

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha02 is released. Version 1.1.0-alpha02 contains these commits.

New Features

  • Motion customization (I0bf9c), (I80e66) is supported for makers to change the default motions during adaptive scaffold state changes. Makers can choose from a set of default entering and exiting transitions, or implement pure custom transitions with the info provided through new motion scopes.
  • Implement fading animation of pane expansion drag handles (46e3c69)
  • Make remembered PaneExpansionState Saveable (61ff76f)

API Changes

  • Add missing pane expansion APis to scaffolds (Ic5bc0)
  • ThreePaneScaffoldDestinationItem.content renamed to contentKey. rememberListDetailPaneScaffoldNavigator and rememberSupportingPaneScaffoldNavigator default type argument changed from Nothing to Any. (I58749)
  • Mark ThreePaneScaffoldState as stable (I64aec)
  • Make drag handle parameters be scoped (Ic0aa2)

Version 1.1.0-alpha01

August 21, 2024

androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01 is released. Version 1.1.0-alpha01 contains these commits.

New Features

  • Introduce pane expansion support of adaptive scaffolds.

API Changes

  • Introduce pane expansion APIs to public (I301d6)
  • Introduced ThreePaneScaffoldState to control pane value transitions. Added overloads of ListDetailPaneScaffold and SupportingPaneScaffold which accept this state. (I5db3b)
  • Introduce pane expansion key and key provider interface (Id621f)

Bug Fixes

  • Fix wrong partition calculation when excluded hinge presents. (9dfd483)

Compose Material3 Adaptive Version 1.0

Version 1.0.0

September 4, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0 is released. Version 1.0.0 contains these commits.

Major features of 1.0.0

Version 1.0.0-rc01

August 21, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-rc01 is released. Version 1.0.0-rc01 contains these commits.

Bug Fixes

  • Fix wrong partition calculation when excluded hinge presents. (9dfd483)

Version 1.0.0-beta04

June 26, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta04 is released. Version 1.0.0-beta04 contains these commits.

Bug Fixes

  • Fixes the issue that when hinge bounds get updated, the layout is not updated accordingly. (71e9cf1)

Version 1.0.0-beta03

June 12, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta03 is released. Version 1.0.0-beta03 contains these commits.

Bug Fixes

  • Fixes crashes caused by incorrect dependency resolution in beta02.

Version 1.0.0-beta02

May 29, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta02 is released. Version 1.0.0-beta02 contains these commits.

Version 1.0.0-beta01

May 14, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits.

Version 1.0.0-alpha12

May 1, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha12 is released. Version 1.0.0-alpha12 contains these commits.

API Changes

  • Add isFlat info to HingeInfo (Ie0516, b/333784198)
  • Make adaptive APIs non-experimental (I1d038)
  • Make adaptive layout APIs non-experimental (Id23df)
  • Changed BackNavigationBehavior from an enum to a value class (Id8757)

Bug Fixes

  • Change transition fraction to a lambda (I6f5a9)
  • Fix the initial state issue of SizeTracker (18326a9)
  • Include hinge list in Posture equality check (6687137)

Version 1.0.0-alpha11

April 17, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha11 is released. Version 1.0.0-alpha11 contains these commits.

API Changes

  • Make scope interfaces sealed. (Iefa57)
  • Introduce AnimatedPaneScope. (I62d73, b/332750742)
  • Make AdaptStrategy sealed and stable. (Ia28b2)
  • Introduce a copy method of PaneScaffoldDirective. (I9291f)
  • Mark ThreePaneScaffoldScope as experimental. (I9d527)
  • Provide easy-to-use scaffold APIs that supports navigation. (I263f0, b/321010778)

Version 1.0.0-alpha10

April 3, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10 is released. Version 1.0.0-alpha10 contains these commits.

API Changes

  • Make default preferred width adaptive and customizable. (Ic3abc)
  • Rename scaffold directive calculation functions. (I10855)
  • Remove paddings and insets from scaffold APIs. (I786f8)
  • Add navigator remember methods without generic types. (I607c3)

Version 1.0.0-alpha09

March 20, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09 is released. Version 1.0.0-alpha09 contains these commits.

API Changes

  • Add state transition fields to ThreePaneScaffoldScope. (I3d917)
  • Reorder scaffold parameters. (I4dff5)
  • Provide default value of AnimatedPane modifier parameter. (I77dd7)

Bug Fixes

  • Include spacer size into pane motions. (a3174ca)

Version 1.0.0-alpha08

March 6, 2024

androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08 is released. Version 1.0.0-alpha08 contains these commits.

New Features

  • Implement delayed sliding in when switching panes. (I1a38e)

API Changes

  • Removed the ThreePaneScaffoldState interface. (I63f23)

Version 1.0.0-alpha07

February 21, 2024