@mui/material

What is @mui/material?

The @mui/material package is a React component library that implements Google's Material Design. It provides a robust, customizable, and accessible collection of components that can be used to build a wide range of user interfaces for web applications.

What are @mui/material's main functionalities?

UI Components

This feature provides pre-built UI components such as buttons, cards, dialogs, and more, which can be easily imported and used in a React application.

import Button from '@mui/material/Button';

function App() {
  return <Button variant='contained'>Click Me</Button>;
}

Layout Components

This feature includes components for creating layouts, such as containers and grid systems, to help organize the content on the page.

import Container from '@mui/material/Container';
import Grid from '@mui/material/Grid';

function App() {
  return (
    <Container>
      <Grid container spacing={2}>
        <Grid item xs={12} sm={6}>
          Content 1
        </Grid>
        <Grid item xs={12} sm={6}>
          Content 2
        </Grid>
      </Grid>
    </Container>
  );
}

Theming

This feature allows for customization of the look and feel of components through theming, enabling developers to define color schemes, typography, and other design elements.

import { createTheme, ThemeProvider } from '@mui/material/styles';
import Button from '@mui/material/Button';

const theme = createTheme({
  palette: {
    primary: {
      main: '#556cd6',
    },
  },
});

function App() {
  return (
    <ThemeProvider theme={theme}>
      <Button color='primary'>Themed Button</Button>
    </ThemeProvider>
  );
}

Icons

This feature provides a large set of icons that can be used in conjunction with other components or standalone.

import AccessAlarmIcon from '@mui/icons-material/AccessAlarm';

function App() {
  return <AccessAlarmIcon />;
}

Other packages similar to @mui/material

antd

Ant Design (antd) is a design system for enterprise-level products. It includes a set of high-quality React components and is similar to @mui/material in providing a comprehensive UI toolkit. Ant Design focuses more on enterprise applications and has a different design language compared to Material Design.

react-bootstrap

React Bootstrap is a React component library that rebuilds the Bootstrap components with React. It offers a different set of components and utilities that adhere to the Bootstrap framework, which has a distinct look and feel from Material Design.

semantic-ui-react

Semantic UI React is the official React integration for Semantic UI. It is similar to @mui/material in that it provides a number of pre-built components, but it follows the design principles of Semantic UI, which differ from Material Design.

chakra-ui

Chakra UI is a simple, modular, and accessible component library that gives you the building blocks to build your React applications. It is similar to @mui/material in its goals but offers a different design system and a focus on simplicity and accessibility.

README

Material UI

Material UI is an open-source React component library that implements Google's Material Design. It's comprehensive and can be used in production out of the box.

Installation

Install the package in your project directory with:

npm install @mui/material @emotion/react @emotion/styled

Documentation

Visit https://mui.com/material-ui/ to view the full documentation.

Questions

For how-to questions that don't involve making changes to the code base, please use Stack Overflow instead of GitHub issues. Use the "material-ui" tag on Stack Overflow to make it easier for the community to find your question.

Examples

Our documentation features a collection of example projects using Material UI.

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 to Material UI 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 of supported versions and contact details for reporting security issues, please refer to the security policy.

Changelog

6.2.0

<!-- generated comparing v6.1.10..master -->

Dec 10, 2024

A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:

• Material UI is now compatible with React 19 (#44672) @DiegoAndai
• Fixed incorrect aria-orientation for vertical sliders. <kbd>ArrowRight</kbd> now increases the value and <kbd>ArrowLeft</kbd> decreases the value in vertical sliders; they were reversed in prior versions. (#44537) @mj12albert