material-components-android

[![Chat](https://img.shields.io/discord/259087343246508035.svg)](https://discord.gg/material-components)

# [MAINTENANCE MODE] Material Components for Android

At Google I/O 2026, Material Android announced that we're "all-in" on Compose,
alongside the official
[Android Compose-first announcement](https://android-developers.googleblog.com/2026/05/android-ui-development-is-compose-first.html),
marking a new chapter in Android development.

**This means that the Views-based Material Components for Android library
(MDC-Android) is now in maintenance mode.**

There are no more planned feature releases for Views, so all projects using the
Views library should begin or continue
[migrating to Compose](https://developer.android.com/develop/ui/compose/migrate/migrate-xml-views-to-jetpack-compose)
to get the latest Material Design and Android platform updates.

For more information, see the following resources:

- [Android Compose-first Blog Post](https://android-developers.googleblog.com/2026/05/android-ui-development-is-compose-first.html)
- [Android Compose-first Doc](https://developer.android.com/develop/ui/compose/first)
- [Material Android is Compose-first Blog Post](https://m3.material.io/blog/material-is-compose-first)
- [Compose Material 3 Getting Started Guide](https://developer.android.com/develop/ui/compose/designsystems/material3)
- [Compose Material 3 Releases Page](https://developer.android.com/jetpack/androidx/releases/compose-material3)
- [Compose Material 3 API Reference Docs](https://developer.android.com/reference/kotlin/androidx/compose/material3/package-summary)
- [Jetpack Compose Homepage](https://developer.android.com/compose)
- [Migrate XML Views to Jetpack Compose Guide](https://developer.android.com/develop/ui/compose/migrate/migrate-xml-views-to-jetpack-compose)

## Getting Started

For information on how to get started with Material Components for Android,
take a look at our [Getting Started](docs/getting-started.md) guide.

## Submitting Bugs or Feature Requests

For usage questions: ask on
[Stack  Overflow](http://stackoverflow.com/questions/tagged/material-components).

Bugs or feature requests should be submitted at our [GitHub Issues section](https://github.com/material-components/material-components-android/issues).

Note: If your issue or feature request is for Material Jetpack Compose, please
file it at the [Compose Issue Tracker](https://issuetracker.google.com/issues/new?component=742043&template=1346811)
instead.

## Useful Links
- [All Components](https://github.com/material-components/material-components-android/tree/master/lib/)
- [Getting Started](docs/getting-started.md)
- [Contributing](docs/contributing.md)
- [Using Snapshot Version](docs/using-snapshot-version.md)
- [Building From Source](docs/building-from-source.md)
- [Catalog App](docs/catalog-app.md)
- [Class
  documentation](https://developer.android.com/reference/com/google/android/material/classes)
  (external site)
- [MDC-Android on Stack
  Overflow](