| 1 |
|
| 2 | <p align="center">
|
| 3 | <a href="https://mui.com/material-ui/" rel="noopener" target="_blank"><img width="150" height="133" src="https://mui.com/static/logo.svg" alt="Material UI logo"></a>
|
| 4 | </p>
|
| 5 |
|
| 6 | <h1 align="center">Material UI</h1>
|
| 7 |
|
| 8 | Material UI is an open-source React component library that implements Google's [Material Design](https://m2.material.io/design/introduction/). It's comprehensive and can be used in production out of the box.
|
| 9 |
|
| 10 | ## Installation
|
| 11 |
|
| 12 | Install the package in your project directory with:
|
| 13 |
|
| 14 | ```bash
|
| 15 | npm install @mui/material @emotion/react @emotion/styled
|
| 16 | ```
|
| 17 |
|
| 18 | ## Documentation
|
| 19 |
|
| 20 | Visit [https://mui.com/material-ui/](https://mui.com/material-ui/) to view the full documentation.
|
| 21 |
|
| 22 | ## Questions
|
| 23 |
|
| 24 | For how-to questions that don't involve making changes to the code base, please use [Stack Overflow](https://stackoverflow.com/questions/tagged/material-ui) instead of GitHub issues.
|
| 25 | Use the "material-ui" tag on Stack Overflow to make it easier for the community to find your question.
|
| 26 |
|
| 27 | ## Examples
|
| 28 |
|
| 29 | Our documentation features [a collection of example projects using Material UI](https://mui.com/material-ui/getting-started/example-projects/).
|
| 30 |
|
| 31 | ## Contributing
|
| 32 |
|
| 33 | Read the [contributing guide](/CONTRIBUTING.md) to learn about our development process, how to propose bug fixes and improvements, and how to build and test your changes.
|
| 34 |
|
| 35 | Contributing to Material UI is about more than just issues and pull requests!
|
| 36 | There are many other ways to [support Material UI](https://mui.com/material-ui/getting-started/faq/#mui-is-awesome-how-can-i-support-the-project) beyond contributing to the code base.
|
| 37 |
|
| 38 | ## Changelog
|
| 39 |
|
| 40 | The [changelog](https://github.com/mui/material-ui/releases) is regularly updated to reflect what's changed in each new release.
|
| 41 |
|
| 42 | ## Roadmap
|
| 43 |
|
| 44 | Future plans and high-priority features and enhancements can be found in the [roadmap](https://mui.com/material-ui/discover-more/roadmap/).
|
| 45 |
|
| 46 | ## License
|
| 47 |
|
| 48 | This project is licensed under the terms of the
|
| 49 | [MIT license](/LICENSE).
|
| 50 |
|
| 51 | ## Security
|
| 52 |
|
| 53 | For details of supported versions and contact details for reporting security issues, please refer to the [security policy](https://github.com/mui/material-ui/security/policy).
|