mui / material-ui
Material UI: Comprehensive React component library that implements Google's Material Design. Free forever.
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing mui/material-ui in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Summary (README)
PreviewMaterial UI is a comprehensive library of React components that features our independent implementation of Google's Material Design system. It's trusted by some of the world's greatest product teams because it's been rigorously battle-tested through more than a decade of development by thousands of open-source contributors.
Material UI's core functionality is extended by MUI X, a suite of complex components for advanced use cases.
Documentation
Get started in the Material UI documentation.
<details> <summary>Older versions</summary>- v5.x (Upgrading from v5 to v6)
- v4.x (Upgrading from v4 to v5)
- v3.x (Upgrading from v3 to v4)
- v0.x (Upgrading to v1)
Note: @next points to pre-releases.
Use @latest for the latest stable release.
Joy UI
This repository also contains Joy UI, an experimental component library that implements our own in-house Joy Design. Joy UI is in beta and development is currently on hold. When starting a new project from scratch, we recommend Material UI over Joy UI because we can guarantee ongoing support.
Keep in mind that the maintainers are primarily focused on other projects and may not be able to respond in a timely manner to issues or pull requests related to Joy UI.
View the Joy UI documentation.
Sponsors
Diamond 💎
<p> <a href="https://www.doit.com/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank"><img height="128" width="128" src="https://mui.com/static/sponsors/doit-square.svg" alt="doit" title="Management Platform for Google Cloud and AWS" loading="lazy" /></a> </p>Diamond sponsors are those who have pledged $1,500/month or more to MUI.
Gold 🏆
via Open Collective or via Patreon
<p> <a href="https://tidelift.com/" rel="noopener sponsored" target="_blank"><img height="96" width="96" src="https://avatars.githubusercontent.com/u/30204434?s=288" alt="tidelift.com" title="Tidelift: Enterprise-ready open-source software." loading="lazy" /></a> <a href="https://www.dialmycalls.com/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank"><img height="96" width="96" src="https://images.opencollective.com/dialmycalls/f5ae9ab/avatar/288.png" alt="dialmycalls.com" title="DialMyCalls: Send text messages, calls, and emails." loading="lazy" /></a> </p> <p> <a href="https://goread.io/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank">Goread.io</a> <a href="https://buzzoid.com/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank">Buzzoid</a> <a href="https://twicsy.com/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank">Twicsy</a> <a href="https://views4you.com/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank">Views4You</a> <a href="https://poprey.com/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank">Poprey</a> <a href="https://www.socialwick.com/instagram/followers/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank">SocialWick</a> <a href="https://www.follower24.de/?utm_source=mui.com&utm_medium=referral&utm_content=readme" rel="noopener sponsored" target="_blank">Follower24</a> </p>Gold sponsors are those who have pledged $500/month or more to MUI.
More backers
See the full list of our backers.
Questions
For how-to questions that don't involve making changes to the code base, please use Stack Overflow instead of GitHub issues.
Examples
<!-- #target-branch-reference -->Our documentation features a collection of example projects.
Premium templates
You can find complete templates and themes in the MUI Store.
Contributing
Read the contributing guide to learn about our development process, how to propose bug fixes and improvements, and how to build and test your changes.
Contributing is about more than just issues and pull requests! There are many other ways to support Material UI beyond contributing to the code base.
Changelog
The changelog is regularly updated to reflect what's changed in each new release.
Roadmap
Future plans and high-priority features and enhancements can be found in the roadmap.
License
This project is licensed under the terms of the MIT license.
Security
For details on supported versions and contact information for reporting security issues, please refer to the security policy.
Sponsoring services
These great services sponsor MUI's core infrastructure:
<div> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://mui.com/static/readme/github-darkmode.svg"> <source media="(prefers-color-scheme: light)" srcset="https://mui.com/static/readme/github-lightmode.svg"> <img alt="GitHub logo" src="https://mui.com/static/readme/github-lightmode.svg" width="80" height="43"> </picture>GitHub lets us host the Git repository and coordinate contributions.
</div> <div> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://mui.com/static/readme/netlify-darkmode.svg"> <source media="(prefers-color-scheme: light)" srcset="https://mui.com/static/readme/netlify-lightmode.svg"> <img alt="Netlify logo" src="https://mui.com/static/readme/netlify-lightmode.svg" width="100" height="27"> </picture>Netlify lets us distribute the documentation.
</div> <div> <img loading="lazy" alt="CodeCov logo" src="https://avatars.githubusercontent.com/u/8226205?s=105" width="35" height="35">CodeCov lets us monitor test coverage.
</div>