This repository was archived by the owner on Dec 11, 2025. It is now read-only.
v55.0.0
This major release introduces breaking changes to CocoaPods dependencies. Please read the breaking changes section for more details.
This release also includes a significant amount of documnetation polish and some accessibility bug fixes.
Breaking changes
CocoaPods +Extension targets have been removed and replaced with more specific targets for the
individual extensions. For example, if you were importing a component's extensions like this before:
pod 'MaterialComponents/Buttons+Extensions'
You'll now need to depend on the individual Button extension targets that you're making use of:
pod 'MaterialComponents/Buttons+ButtonThemer'
To see a full list of available extensions for a given component, read the
MaterialComponents.podspec file.
API changes
Component changes
Tabs
Changes
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Rename Examples.md to examples.md (Mohammad Cazi)
- Rename Usage.md to usage.md (Mohammad Cazi)
- Update README.md (Mohammad Cazi)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
- readme update. (#3613) (Mohammad Cazi)
- regenerating tabs after file change. (#3623) (Mohammad Cazi)
schemes/Color
Changes
- Fix build breakage. (Jeff Verkoeyen)
- Update the default error color to match spec. (#3591) (featherless)
- [Themes] Add deprecation notice to APIs and remove from the site. (#3636) (featherless)
- [schemes/Color Flesh out the documentation. (#3668) (featherless)
schemes/Typography
Changes
- Add docs stubs. (#3609) (featherless)
- [Themes] Add deprecation notice to APIs and remove from the site. (#3636) (featherless)
- [Typography] Add TypographyScheme example (#3607) (Robert Moore)
- [Typography] Preliminary Typography Scheme README (#3671) (ianegordon)
FeatureHighlight
Changes
- Allow setting accessibilityHint (#3649) (Robert Moore)
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Remove theming preambles and regenerate root readme. (#3635) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3620) (featherless)
AppBar
Changes
- Add animated gif to the readme. (#3677) (featherless)
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Make the App Bar appear as "Top App Bar" in the docsite. (#3670) (featherless)
- Make the interface builder and modal presentation examples be dragons. (#3659) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3634) (featherless)
Buttons
Changes
- Add documentation describing variants to buttons, chips and cards (#3600) (John Detloff)
- Add outlined button gif. (#3639) (featherless)
- Break the docs into separate articles and run the readme generator. (#3605) (featherless)
- Ensure buttons and cards reset their states correctly (#3599) (John Detloff)
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Theme the typical use example with the injected schemes. (#3603) (featherless)
- [scripts] Ensure that asset urls are remapped when generating readmes. (#3640) (featherless)
ButtonBar
Changes
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Mark all of the AppBar implementation component examples as dragons. (#3596) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Remove from the website. (#3638) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3614) (featherless)
TextFields
Changes
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
- [TextField] floating placeholder overlaps with border. (#3606) (Mohammad Cazi)
- [Textfields] readme auto generated update. (#3628) (Mohammad Cazi)
- [scripts] Ensure that asset urls are remapped when generating readmes. (#3640) (featherless)
- fixing color mapping for floatingNormal and floatingActive Colors. (#3617) (Mohammad Cazi)
Chips
Changes
- Add documentation describing variants to buttons, chips and cards (#3600) (John Detloff)
- Auto Generated README update. (#3621) (Mohammad Cazi)
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Replace "stroked" with "outlined" in the examples. (#3647) (featherless)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
Snackbar
Changes
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Global replace of "utilize" vs "use". (#3662) (Adrian Secord)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3627) (featherless)
Cards
Changes
- Add documentation describing variants to buttons, chips and cards (#3600) (John Detloff)
- Ensure buttons and cards reset their states correctly (#3599) (John Detloff)
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Global replace of "utilize" vs "use". (#3662) (Adrian Secord)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3618) (featherless)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
BottomAppBar
Changes
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3615) (featherless)
Slider
Changes
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3626) (featherless)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
NavigationBar
Changes
- Fix broken link. (#3632) (featherless)
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Mark all of the AppBar implementation component examples as dragons. (#3596) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3622) (featherless)
- [AppBar] Nest all of the implementation detail components under AppBar. (featherless)
- [ButtonBar] Remove from the website. (#3638) (featherless)
ShadowLayer
Changes
- Global replace of "utilize" vs "use". (#3662) (Adrian Secord)
ActivityIndicator
Changes
- Break the docs into separate articles and run the readme generator. (#3608) (featherless)
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
BottomSheet
Changes
- Fix issue causing black squares on bottom sheet rotation (#3630) (John Detloff)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
Typography
Changes
- Add TypographyScheme example (#3607) (Robert Moore)
- Add deprecation notice to the MDCTypography APIs and README (#3633) (featherless)
Dialogs
Changes
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Global replace of "utilize" vs "use". (#3662) (Adrian Secord)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3619) (featherless)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
BottomNavigation
Changes
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3616) (featherless)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
- [scripts] Ensure that asset urls are remapped when generating readmes. (#3640) (featherless)
PageControl
Changes
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3624) (featherless)
- [Catalog] Make many examples be dragons. (#3642) (featherless)
AnimationTiming
Changes
- Add a gif to the readme. (#3641) (featherless)
Collections
Changes
- Global replace of "utilize" vs "use". (#3662) (Adrian Secord)
HeaderStackView
Changes
- Mark all of the AppBar implementation component examples as dragons. (#3596) (featherless)
- Remove color theming docs and mark the color themer as to be deprecated. (#3612) (featherless)
- [AppBar] Nest all of the implementation detail components under AppBar. (featherless)
FlexibleHeader
Changes
- Flatten all +Extensions CocoaPods targets into standalone targets. (#3572) (featherless)
- Global replace of "utilize" vs "use". (#3662) (Adrian Secord)
- Mark all of the AppBar implementation component examples as dragons. (#3596) (featherless)
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3610) (featherless)
Themes
Changes
ProgressView
Changes
- Regenerate component docs with automatic API links. (#3673) (featherless)
- Split the documentation into separate articles and run the readme generator. (#3625) (featherless)
Palettes
Changes
- Improve example text contrast (#3590) (Robert Moore)
- [Catalog] Make many examples be dragons. (#3642) (featherless)