Material Design for XR

Build with Material components and layouts that adapt for XR
Latest Update Stable Release Release Candidate Beta Release Alpha Release
October 22, 2025 - - - 1.0.0-alpha12

Declaring dependencies

To add a dependency on XR Compose Material3 core, 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 {
    // Use to implement XR Compose Material3
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha12"
}

Kotlin

dependencies {
    // Use to implement XR Compose Material3
   implementation("androidx.xr.compose.material3:material3:1.0.0-alpha12")
}

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.

Version 1.0

Version 1.0.0-alpha12

October 22, 2025

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

New Features

  • Added SpaceModeToggleButton for switching between HomeSpace and FullSpace (Ic6865)

Bug Fixes

  • Improve XR Toolbars (Ied1f5)

Version 1.0.0-alpha11

August 27, 2025

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

Bug Fixes

  • Fix behavior of FAB in XR NavRail (Ibe20b)

Version 1.0.0-alpha10

July 30, 2025

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

New Features

  • Create XR implementation and ComponentOverride for Horizontal and Vertical Toolbar (0e9496c, dcfef96)

Bug Fixes

  • Fix XR dialog not showing some content (c82e61b)

Version 1.0.0-alpha08

May 20, 2025

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

Bug Fixes

  • Fix crash when ListDetailPaneScaffold or SupportingPaneScaffold has no children (46df990)
  • Lower Material XR minSdk to 24 (6064706)

Version 1.0.0-alpha07

May 7, 2025

androidx.xr.compose.material3:material3:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

API Changes

  • Projects released with Kotlin 2.0 require KGP 2.0.0 or newer to be consumed. (Idb6b5)

Version 1.0.0-alpha06

March 26, 2025

androidx.xr.compose.material3:material3:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

Version 1.0.0-alpha05

March 12, 2025

androidx.xr.compose.material3:material3:1.0.0-alpha05 is released. Version 1.0.0-alpha05 contains these commits.

New Features

  • TopAppBar is spatialized into an Orbiter by default when using EnableXrComponentOverrides.
  • Material AlertDialog is spatialized into a SpatialPanel by default when using EnableXrComponentOverrides.

API Changes

  • Rename ComponentOverride types to Override, and ComponentOverrideContext types to OverrideScope (Id973c)

Bug Fixes

  • Fix aliasing and incorrect scrimming on spatialized NavigationRail and NavigationBar. (I9db52)

Version 1.0.0-alpha04

February 26, 2025

androidx.xr.compose.material3:material3:1.0.0-alpha04 is released. Version 1.0.0-alpha04 contains these commits.

New Features

  • ListDetailPaneScaffold and SupportingPaneScaffold use SpatialPanels by default when using EnableXrComponentOverrides (I166b0)

API Changes

  • DefaultNavigationRailOrbiterProperties and DefaultNavigationBarOrbiterProperties getters are no longer@Composable (I61618)
  • LocalNavigationRailOrbiterProperties and LocalNavigationBarOrbiterProperties are no longer nullable (I61618)

Version 1.0.0-alpha03

February 12, 2025

androidx.xr.compose.material3:material3:1.0.0-alpha03 is released with no notable changes since the last alpha. Version 1.0.0-alpha03 contains these commits.

Version 1.0.0-alpha02

January 29, 2025

androidx.xr.compose.material3:material3:1.0.0-alpha02 is released. Version 1.0.0-alpha02 contains these commits.

New Features

  • Enable customization of Orbiter properties on XR NavigationBar and NavigationRail. (Ic300f)

API Changes

  • Create ability to override ThreePaneScaffold on XR (Ib66f1)
  • Implement non-animated Pane override for XR (I7f620)
  • Add and use new experimental annotation ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)

Bug Fixes

  • Pin Material3 XR's dependency on XR Compose. (Ia02cc)

Version 1.0.0-alpha01

December 12, 2024

androidx.xr.compose.material3:material3:1.0.0-alpha01 is released.

Features of Initial Release

Initial developer release of Material Design for XR. Using the existing Material 3 library, components and adaptive layouts are enhanced with spatial UI behaviors. You can build directly with M3 XR components, or adapt your current implementation by adding the EnableXrComponentOverrides wrapper. Learn more in this developer guide.

Supported XR adaptations:

Known Issues

  • ListDetailPaneScaffold and SupportingPaneScaffold currently don’t support multiple spatial panels