Repository navigation
Adopt Material Design 3 / Material You #29345
Copy link
Copy link
Open
Labels
breaking changeIntroduces changes that are not backward compatible.Introduces changes that are not backward compatible.design: materialThis is about Material Design, please involve a visual or UX designer in the processThis is about Material Design, please involve a visual or UX designer in the processdesign: material youon holdThere is a blocker, we need to wait.There is a blocker, we need to wait.scope: all componentsWidespread work has an impact on almost all components.Widespread work has an impact on almost all components.type: new featureExpand the scope of the product to solve a new problem.Expand the scope of the product to solve a new problem.umbrellaFor grouping multiple issues to provide a holistic viewFor grouping multiple issues to provide a holistic view
Description
I'm sure you're tracking the pulse of material design standards like me and others. That being said, material ui version 3 is out.
We should track MUI being migrated from Material Design v2 to Material Design version v3.
I'm sure they'll be a few tickets that come out requesting the adoption, so I figured this ticket could act as a stub and catch-all for MUI support for the design language's latest update.
Cheers
References
- MD 3 Docs https://m3.material.io/
- MD 2 Docs https://m2.material.io/
- Ionic's discussion on the problem feat: Add Material Design 3 (Material You) support ionic-team/ionic-framework#24282
- Vuetify's discussion on the problem Material Design 3 (Material You) vuetifyjs/vuetify#14332
- Quasar's discussion on the problem Adopt Material Design 3 specs quasarframework/quasar#11139
- Google's discussion on the problem Implement Material You material-components/material-web#2441
- The docs traffic on MD 3 vs MD 2: https://www.similarweb.com/website/m3.material.io/?competitors=material.io
- Material Design traction on Figma MD 2 Figma file vs. MD 3 Figma file
- January 12, 2022: MD2 4.8k stars 256k copies, MD3 1.9k stars 39.6k copies
- March 24, 2022: MD2 5.6k stars 277k copies, MD3 4.2k stars 91k copies
- August 23, 2022: MD2 6.5k stars 307k copies, MD3 5.8k stars 132k copies
- October 6, 2022: MD2 6.8k stars 315k copies, MD3 6.6k stars 155k copies
- December 20, 2022: MD2 7.2k stars 327k copies, MD3 8.9k stars 214k copies
- React Native Paper: Material Design 3 callstack/react-native-paper#3126
- Flutter Update text fields to support Material 3 flutter/flutter#103537
- Angular Material: feat(Material): Material You Support angular/components#22738
Design kits
- [figma] Add support for Material Design v3 mui-design-kits#135
- Material Design v3 mui-design-kits#103
Real adoptions of Material You in the wild?
Desktop
- https://relay.material.io/
- https://httpie.io/app feels inspired by it
- Gmail partially, which feels relatively yolo
- Others?
Mobile
- Google Pixel Phones. "Canalys puts Google fifth in U.S. phone market share, with just a 1.7% in Q3 2022." source. It's insignificant. All the other phone manufacturers skin Android, so don't use Material Design 3.
- Others?
Migration
If you wish to contribute, start with the contributing guide
Progress
List of components and their current migration status
✅ Done
- Badges: Playground | Issue | Specs
- Chips: Playground | Issue | Specs
- Circular Progress Indicator: Playground | Issue | Specs
- Common Buttons: Playground | Issue | Specs
- Dividers: Playground | Issue | Specs
- Linear Progress Indicator: Playground | Issue | Specs
- Sliders: Playground | Issue | Specs
⏳ In progress
⭐ Ready to take
- Bottom App Bar (Previously included in App Bar)
- Bottom Sheet (Previously included in Drawer)
- Buttons:
- Card
- Dialog
- Navigation Bar (Previously named Bottom Navigation)
- Navigation Drawer (Previously included in Drawer)
- Navigation Rail (Previously Drawer “Mini” variant)
- Search (New component)
- Side sheet (Previously included in Drawer)
- Tab
- Top App Bar (Previously included in App Bar)
- Typography
✋🏼 On hold
- Blocked
- Waiting for Base UI’s hook:
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
breaking changeIntroduces changes that are not backward compatible.Introduces changes that are not backward compatible.design: materialThis is about Material Design, please involve a visual or UX designer in the processThis is about Material Design, please involve a visual or UX designer in the processdesign: material youon holdThere is a blocker, we need to wait.There is a blocker, we need to wait.scope: all componentsWidespread work has an impact on almost all components.Widespread work has an impact on almost all components.type: new featureExpand the scope of the product to solve a new problem.Expand the scope of the product to solve a new problem.umbrellaFor grouping multiple issues to provide a holistic viewFor grouping multiple issues to provide a holistic view
Projects
- StatusShow more project fieldsSelected
Activity
mnajdova commentedon Nov 5, 2021
jpmtrabbold commentedon Nov 23, 2021
cryptoAlgorithm commentedon Jan 10, 2022
Hi, I was about to start my own feature request, but found this. I think material v3 does look way more expressive and vivid than v2, and Google's own material web components is also in the progress of implementing Material You (material-components/material-web#2441).
If nobody wants to take up this task, I can plan and gradually migrate some mui components to material v3 standards. @mnajdova, is there anything blocking that needs to be completed before migration can start? If not, I think we can start with a checklist of components in order of importance and visual difference from material v2 -> v3.
mnajdova commentedon Jan 11, 2022
It is a breaking change, so I am not sure that we can start with it right away (at least we cannot update the components which are part of
@mui/material). We could try to adopt the styles to some of the components that we have inside@mui/material-next- this is our experimental package that depends on@mui/basethat we envision will be the replacement for@mui/materialv6. In my opinion this should be a good start. @mui-org/core what do you think?@cryptoAlgorithm feel free to kick off this effort if you want to. Check first which components we already have in the
@mui/material-nextpackage and try to experiment with some of those if you want to.cryptoAlgorithm commentedon Jan 11, 2022
Ok, great. Maybe this can be introduced as part of the material-ui v6 update? Since by then, material v3 styles should be quite common across sites using material design. We might want to wait and see how Google handles this in their own Material Web Components library, and how they actually look.
michaldudak commentedon Jan 12, 2022
Agree. Just note that
material-nextis our experimental (playground) package. We intend to test different shapes of the API there and introduce breaking changes without notice, so it's not safe to depend on it in production.leonardorafael commentedon Jan 12, 2022
[-]Adopt material design 3 specs [/-][+]Adopt Material Design 3 / Material You[/+]172 remaining items
MIreland commentedon Oct 29, 2025
@alexprinsen-barntools
Mind sharing where you saw mui tailwind integration?
t-unimorphic commentedon Dec 9, 2025
The Android components in Adaptive Material UI have been updated to Material Design 3. If you don't want the adaptive behaviour you can import the Android components directly docs
kmetta4 commentedon Jan 13, 2026
Hi. Thanks for all the amazing work put in to this library. is there any update on the Material You/MD3 implementaion?
akarray commentedon Jan 15, 2026
@siriwatknp I understand that priorities can change, and focusing on Base UI going forward makes sense.That said, clearer and more transparent communication with the community would really help.
This lack of updates is creating frustration for many developers.
mokosiy commentedon Jan 16, 2026
@siriwatknp Simply remove MD3 support from the roadmap. This will stop everyone from expecting an update and distract you from important work.
Aditya1234vishwakarma commentedon Mar 5, 2026
I'm very excited for support of Material Design 3 in the MUI because it is only one that I have trust for the react and specially in NEXT JS. ❤️❤️❤️
abriginets commentedon Apr 10, 2026
I wonder if there's a chance MUI v10 would support Material You by default or at least as an opt-in theme option. Given the fact that team is going to prioritize theming and becoming style-engine agnostic.
selimbei commentedon Apr 17, 2026
bro is waiting for Material Design 4 😅
zju1 commentedon Apr 18, 2026
DaliborHomola commentedon Apr 19, 2026
I build internal apps and overall I’m very happy with the components. We use the premium plan, and having pre-styled data grids, charts, plus now calendar and AI chat is a huge time saver—I don’t know another UI library that covers all of this.
But I’m also getting nervous. We’ve been also talking about Material Design 3 in our team for 5 years—how many times did we plan to build the next app with it, even delay launches… and then nothing.
Given the premium price, that gap is honestly pretty frustrating.
Aditya1234vishwakarma commentedon May 1, 2026
pjanaya commentedon May 26, 2026
Hi guys! I was wondering if this is ever going to happen. Does anybody know? I'm at a point where I need to decide whether to customize MUI to adopt a more v3-like style, use a different library, or maybe wait a bit if this is on the horizon. Thanks!
abriginets commentedon May 26, 2026
@pjanaya they plan to support it, although there are no concrete deadlines atm. I wouldn't expect it this year.
fatmalama commentedon Jun 3, 2026
@pjnaya various alternatives have been mentioned. Personally, I went with https://github.com/BobesCZ/mui-create-material-you-theme as it skins MUI and is not a replacement. I wanted to try https://github.com/matraic/m3e as it seems very complete but it doesn't do server side rendering (big downside for me) and it's not MUI so you'd have to rewrite