material-components-android README

The project's README from github.com/material-components/material-components-android. As one markdown file: README.md.

Chat

[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, 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 to get the latest Material Design and Android platform updates.

For more information, see the following resources:

Getting Started

For information on how to get started with Material Components for Android, take a look at our Getting Started guide.

Submitting Bugs or Feature Requests

For usage questions: ask on Stack Overflow.

Bugs or feature requests should be submitted at our GitHub Issues section.

Note: If your issue or feature request is for Material Jetpack Compose, please file it at the Compose Issue Tracker instead.

Documentation

material-components-android (material-components/material-components-android)

Searching Database…

What is this?Material Components for Android (MDC-Android) is Google's library of modular, customizable Material Design UI components for building Android apps.
Is it built on the classic Android View system or on Jetpack Compose?It is Views-based — classic Android UI with XML layouts — not Jetpack Compose, which Google now points everyone to instead.
How do I add it to my Android app?Follow the Getting Started guide linked at the top of the README — it walks you through adding the Material Components dependency to your project.
Can I run it on its own, or does it live inside an app?It is a UI library, not a standalone app: the components ship as a dependency of your own Android app project and render inside its screens.
The repo is marked maintenance mode — what does that mean for my project?No more feature releases are planned for the Views library. Google is all-in on Compose, and the README tells projects using Views to begin or continue migrating to Compose for the latest Material Design updates.
Why did Google put MDC-Android into maintenance mode?At Google I/O 2026, Material Android announced it is all-in on Compose, alongside Android's official Compose-first announcement — so new Material Design work happens in Compose rather than in this Views library.
Where can I browse and preview the components before writing code?The Useful Links section points to an All Components page, a Catalog App, and external class documentation for exploring the full component set.
What is the Compose replacement if I migrate?Compose Material 3 — the README links its Getting Started guide, releases page, and API reference, plus a step-by-step guide for migrating XML Views to Jetpack Compose.
Can I test unreleased changes via snapshot builds?Yes — the Useful Links section includes a 'Using Snapshot Version' guide, and there is also a 'Building From Source' doc for compiling the library yourself.
Size
179.2 MB
Stars
17.4K
Age
9y
Commits · 90 Days