Skip to content

Material UI

This is the documentation for the Material UI package. It contains comprehensive guides, components, and utilities for building user interfaces.

Components

Design Resources

Discover More

  • Showcase: Check out these public apps using Material UI to get inspired for your next project.
  • Related projects: A carefully curated list of tools that expand or build on top of Material UI.
  • Roadmap: Keep up with ongoing projects and help shape the future of Material UI.
  • Sponsors and Backers: Support the development of the open-source projects of the MUI organization through crowdfunding.
  • Vision: Our vision is to provide an elegant React implementation of the Material Design guidelines that can be customized to fully match your brand.
  • Changelog: Material UI follows Semantic Versioning 2.0.0.

Material UI

Getting Started

  • Installation: Install Material UI, the world's most popular React UI framework.
  • Usage: Learn the basics of working with Material UI components.
  • Model Context Protocol (MCP) for MUI: Access the official Material UI docs and code examples in your AI client.
  • Example projects: A collection of examples and scaffolds integrating Material UI with popular libraries and frameworks.
  • New Free React Templates: Browse our collection of free React templates to get started building your app with Material UI, including a React dashboard, React marketing page, and more.
  • Learning resources: New to Material UI? Get up to speed quickly with our curated list of learning resources.
  • Design resources: Be more efficient designing and developing with the same library.
  • Frequently Asked Questions: Stuck on a particular problem? Check some of these common gotchas first in the FAQ.
  • Supported components: The following is a list of Material Design components & features.
  • Supported platforms: Learn about the platforms, from modern to old, that are supported by Material UI.
  • Support: Learn how to get support for Material UI components, including feature requests, bug fixes, and technical support from the team.

Customization

  • Overriding component structure: Learn how to override the default DOM structure of Material UI components.
  • Dark mode: Material UI comes with two palette modes: light (the default) and dark.
  • Color: Convey meaning through color. Out of the box you get access to all colors in the Material Design guidelines.
  • Right-to-left support: Learn how to implement right-to-left (RTL) text with Material UI to support languages such as Arabic, Persian, and Hebrew.
  • Shadow DOM: The shadow DOM lets you encapsulate parts of an app to keep them separate from global styles that target the regular DOM tree.
  • Default theme viewer: This tree view allows you to explore how the theme object looks like with the default values.
  • Theming: Customize Material UI with your theme. You can change the colors, the typography and much more.
  • Creating themed components: Learn how to create fully custom components that accept your app's theme.
  • Themed components: You can customize a component's styles, default props, and more by using its component key inside the theme.
  • Palette: The palette enables you to modify the color of the components to suit your brand.
  • Typography: The theme provides a set of type sizes that work well together, and also with the layout grid.
  • Spacing: Use the theme.spacing() helper to create consistent spacing between the elements of your UI.
  • Shape: The shape is a design token that helps control the border radius of components.
  • Breakpoints: API that enables the use of breakpoints in a wide variety of contexts.
  • Container queries: Material UI provides a utility function for creating CSS container queries based on theme breakpoints.
  • Density: How to apply density to Material UI components.
  • z-index: z-index is the CSS property that helps control layout by providing a third axis to arrange content.
  • Transitions: These theme helpers allow you to create custom CSS transitions, you can customize the durations, easings and more.
  • CSS Layers: Learn how to generate Material UI styles with cascade layers.

Guides

  • Building extensible themes: Learn how to build extensible themes with Material UI.
  • Minimizing bundle size: Learn how to reduce your bundle size and improve development performance by avoiding costly import patterns.
  • Server rendering: The most common use case for server-side rendering is to handle the initial render when a user (or search engine crawler) first requests your app.
  • Responsive UI: Material Design layouts encourage consistency across platforms, environments, and screen sizes by using uniform elements and spacing.
  • Testing: Write tests to prevent regressions and write better code.
  • Localization: Localization (also referred to as "l10n") is the process of adapting a product or content to a specific locale or market.
  • API design approach: We have learned a great deal regarding how Material UI is used, and the v1 rewrite allowed us to completely rethink the component API.
  • TypeScript: You can add static typing to JavaScript to improve developer productivity and code quality, thanks to TypeScript.
  • Composition: Material UI tries to make composition as easy as possible.
  • Content Security Policy (CSP): This section covers the details of setting up a CSP.

Integrations

  • Next.js integration: Learn how to use Material UI with Next.js.
  • Routing libraries: By default, the navigation is performed with a native <a> element. You can customize it, for instance, using Next.js's Link or react-router.
  • Using styled-components: Learn how to use styled-components instead of Emotion with Material UI.
  • Style library interoperability: While you can use the Emotion-based styling solution provided by Material UI, you can also use the one you already know, from plain CSS to styled-components.
  • Theme scoping: Learn how to use multiple styling solutions in a single Material UI app.

Migration

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 193kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 193kUpdated Claude CodeCodexVerifiedInstall