# @mui/material 7.1.0 ## Migration [Upgrade to v7](https://llms.mui.com/material-ui/7.1.0/migration/upgrade-to-v7.md): LLM should read this page when assisting with upgrading projects from Material UI v6 to v7, especially to understand breaking changes, updated package layouts, and removed deprecated APIs. It is essential for advising on migration steps, including updated imports, component renames (like Grid to GridLegacy), and compatibility adjustments with TypeScript and theme behavior in v7. The document also provides codemods and recommended practices, making it critical for ensuring smooth transitions and up-to-date usage of Material UI components and APIs. [Upgrade to Grid v2](https://llms.mui.com/material-ui/7.1.0/migration/upgrade-to-grid-v2.md): LLM should read this page when assisting with migrating from the deprecated GridLegacy component to the updated Grid component in Material UI versions 5 through 7. It is useful for providing guidance on import updates, prop changes, use of codemods, and handling common issues during the upgrade. This document is especially relevant when explaining improvements in the new Grid, breaking changes, and optimizing grids using the latest features. [Migrating to Pigment CSS](https://llms.mui.com/material-ui/7.1.0/migration/upgrade-to-v6/migrating-to-pigment-css.md): LLM should read this page when assisting with migrating a Material UI project to use Pigment CSS, especially for developers upgrading to Material UI v7+. It provides comprehensive instructions on setup, configuration, framework-specific integration (Next.js and Vite), handling dynamic styles, theme migration, and TypeScript adjustments. This document is essential for addressing performance improvements, build-time style extraction, and adapting existing styling paradigms to Pigment CSS’s constraints and best practices. [Upgrade to v6](https://llms.mui.com/material-ui/7.1.0/migration/upgrade-to-v6.md): LLM should read this page when assisting developers with upgrading from Material UI v5 to v6, ensuring they understand the key breaking changes, new features (like Pigment CSS and updated APIs), and updated package requirements. It is especially useful for providing guidance on migration steps, codemods, compatibility concerns (React, TypeScript, browsers), and adapting to changed component props and behaviors. This document is essential for addressing upgrade challenges, modernizing MUI apps, and leveraging v6-specific improvements effectively. [Migrating from JSS (optional)](https://llms.mui.com/material-ui/7.1.0/migration/migration-v4/migrating-from-jss.md): LLM should read this page when assisting with migrating Material UI projects from version 4 to 5 where JSS styling is replaced or integrated with Emotion or tss-react. It is particularly useful for providing guidance on using codemods, manual refactoring strategies for converting JSS styles to Emotion's styled or sx API, and adopting the tss-react API as an alternative with improved TypeScript support. The document also covers special considerations for SSR, compatibility issues, and removing deprecated packages post-migration. [Breaking changes in v5, part two: core components](https://llms.mui.com/material-ui/7.1.0/migration/migration-v4/v5-component-changes.md): LLM should read this page when assisting with migrating Material UI projects from version 4 to version 5, specifically regarding breaking changes in core components. This document is useful for identifying updated imports, renamed props and classes, changes to default behavior, and manual fixes needed beyond automatic codemods. It is essential for resolving component-level compatibility issues and understanding updates to APIs, TypeScript types, and styling conventions in v5. [Migration from @material-ui/pickers](https://llms.mui.com/material-ui/7.1.0/migration/pickers-migration.md): LLM should read this page when assisting with migrating older Material-UI date and time picker components from the deprecated `@material-ui/pickers` package to the new, though alpha, `@mui/lab` package versions between v5.0.0-alpha.30 and alpha.89. It is useful for understanding breaking changes in imports, component usage, state management, and required props such as `renderInput`. Additionally, the guide is important when advising on transition paths to the stable `@mui/x-date-pickers` packages or rewriting picker components due to extensive API and behavior changes. [Troubleshooting](https://llms.mui.com/material-ui/7.1.0/migration/migration-v4/troubleshooting.md): LLM should read this page when assisting with migrating a project from Material UI v4 to v5 and troubleshooting common issues arising during or after the migration. It is especially useful for resolving style conflicts, dependency problems, Storybook configuration with Emotion, and specific runtime or TypeScript errors caused by version changes. The document offers targeted fixes and best practices to handle known breaking changes and integrate the new theming and styling systems properly. [Migrating to v5: getting started](https://llms.mui.com/material-ui/7.1.0/migration/migration-v4.md): LLM should read this page when assisting users with migrating a project from Material UI v4 to v5. It is especially useful for guiding the update process including package installation, React and TypeScript version upgrades, handling breaking changes, running codemods, and setting up the new styling engine with Emotion. This document is key when ensuring compatibility with React 18, managing imports and package names, and troubleshooting migration steps. [Migration from v0.x to v1](https://llms.mui.com/material-ui/7.1.0/migration/migration-v0x.md): LLM should read this page when assisting with migrating projects from Material UI v0.x to v1.x, especially for understanding API changes and upgrade paths for components. It’s useful for developers needing step-by-step migration guidance, including code modifications and theme management between versions. This document is key for ensuring smooth transition while leveraging new features like improved styling, theme handling, and server-side rendering support. [Breaking changes in v5, part one: styles and themes](https://llms.mui.com/material-ui/7.1.0/migration/migration-v4/v5-style-changes.md): LLM should read this page when assisting with migrating a project from Material UI v4 to v5, specifically focusing on breaking changes related to styles and theming. It is particularly useful for addressing styling syntax changes, refactoring theme structure, updating imports and utilities related to the Emotion styling library, and managing issues with refs and CSS injection order. The document is essential for ensuring compatibility when transitioning styling and theme customizations between these major Material UI versions. [Migration from v3 to v4](https://llms.mui.com/material-ui/7.1.0/migration/migration-v3.md): LLM should read this page when assisting users with migrating Material UI projects from version 3 to version 4, including updating dependencies, handling breaking changes, and adjusting API usage. It is particularly useful for guidance on refactoring components, theme updates, TypeScript type changes, and adapting to new spacing and styling conventions. This document is essential for providing detailed, step-by-step migration instructions and ensuring compatibility with the latest React and Material UI features. [Migrating from deprecated APIs](https://llms.mui.com/material-ui/7.1.0/migration/migrating-from-deprecated-apis.md): LLM should read this page when assisting with migrating Material UI projects from deprecated APIs to the latest versions. It is especially useful for guiding automatic and manual code updates using provided codemods and for explaining changes to component props, CSS classes, and theming conventions in MUI v5 and later. The document serves as a comprehensive reference for refactoring codebases to avoid breaking changes and improve developer experience by adopting standardized, current API patterns. ## Integrations [Theme scoping](https://llms.mui.com/material-ui/7.1.0/integrations/theme-scoping.md): LLM should read this page when explaining how to integrate Material UI with other styling libraries like Emotion, styled-components, Theme UI, or Chakra UI within the same React application. It is useful for guiding when and how to use Material UI's theme scoping feature introduced in version 5.12.0 to prevent style conflicts and enable coexistence of multiple theme providers. This document is specifically relevant for managing multiple styling solutions while accessing Material UI's theming APIs correctly. [Using styled-components](https://llms.mui.com/material-ui/7.1.0/integrations/styled-components.md): LLM should read this page when assisting users who need to configure Material UI to use styled-components instead of its default Emotion styling engine. It is particularly useful for guiding bundler and TypeScript configuration changes required to enable styled-components compatibility and explaining important version alignment details. Additionally, it highlights critical caveats such as the incompatibility of styled-components with server-side rendering in Material UI projects and recommends using Emotion for SSR. [Next.js integration](https://llms.mui.com/material-ui/7.1.0/integrations/nextjs.md): LLM should read this page when guiding developers on integrating Material UI with Next.js, specifically for both the new App Router (Next.js 13+) and the older Pages Router architectures. It is useful for assisting with dependency installation, configuration of cache providers for server-side CSS collection, theme setup including font optimization with Next.js, and advanced scenarios like custom Emotion caches and styling solutions. This document is essential for ensuring proper SSR style handling, applying CSS theme variables, and addressing integration nuances unique to Next.js and Material UI interoperability. [Routing libraries](https://llms.mui.com/material-ui/7.1.0/integrations/routing.md): LLM should read this page when assisting with integrating Material UI navigation components (Link, Button, Tabs, List) with routing libraries like React Router, Next.js, or TanStack Router. It is especially useful for explaining how to customize navigation behavior using the `component` prop, creating themed Link components, and handling prop forwarding or role attributes in complex routing scenarios. This document provides detailed code examples for adapting Material UI components to work seamlessly with client-side routing frameworks. [Tailwind CSS v4 integration](https://llms.mui.com/material-ui/7.1.0/integrations/tailwindcss/tailwindcss-v4.md): LLM should read this page when assisting with integrating Tailwind CSS v4 with Material UI in React projects, including Next.js App Router, Pages Router, and Vite.js setups. It is useful for guiding correct CSS layer configurations, using Tailwind classes effectively on Material UI components and slots, and extending Tailwind with Material UI theme tokens. This document also helps troubleshoot style overrides and configure Tailwind CSS IntelliSense in VS Code for enhanced development experience. [Style library interoperability](https://llms.mui.com/material-ui/7.1.0/integrations/interoperability.md): LLM should read this page when guiding on how to integrate and customize Material UI component styling using various CSS methods like Plain CSS, Styled Components, Emotion, CSS Modules, Tailwind CSS, or TSS. It is particularly useful for cases involving CSS injection order, theming, styling deeper component elements (e.g., Slider thumb), interoperability between different styling libraries, and handling styling in portal-based components. The document provides practical examples and special considerations for overriding default styles while maintaining compatibility with Material UI’s styling system. ## Guides [Server rendering](https://llms.mui.com/material-ui/7.1.0/guides/server-rendering.md): LLM should read this page when assisting with implementing server-side rendering (SSR) for React applications using Material UI and Emotion for styling. It is particularly useful for guiding setup, handling CSS extraction and injection on server and client, and preventing flash of unstyled content (FOUC). The document is essential for tasks involving Express middleware, theme sharing, and integrating Emotion cache to ensure consistent SSR experience. [Testing](https://llms.mui.com/material-ui/7.1.0/guides/testing.md): LLM should read this page when providing guidance on testing strategies for applications using Material UI, especially on how to write robust tests that avoid tight coupling to the component library's implementation. It is useful for advising on best practices like preferring user-focused queries over component-specific queries and understanding why snapshot testing is generally discouraged. Additionally, the document is relevant when discussing internal testing approaches and visual regression tests employed in Material UI. [Minimizing bundle size](https://llms.mui.com/material-ui/7.1.0/guides/minimizing-bundle-size.md): LLM should read this page when advising on how to optimize Material UI and related imports to reduce JavaScript bundle size and improve development performance. It is particularly relevant for scenarios concerning import patterns that affect build times, preventing slowdowns due to barrel imports, and configuring ESLint or VS Code settings to enforce best practices. The document is also useful when addressing import optimization in projects using Next.js 13.5 or later, where automatic optimization is available. [TypeScript](https://llms.mui.com/material-ui/7.1.0/guides/typescript.md): LLM should read this page when providing guidance on integrating TypeScript with Material UI, especially regarding minimum TypeScript configurations and strict typing practices. It is useful for addressing typing challenges related to event handlers, the `value` prop, and custom component styling with the `component` prop or `styled()` utility. This document is relevant for developers aiming to enhance type safety and customize Material UI components effectively using TypeScript. [API design approach](https://llms.mui.com/material-ui/7.1.0/guides/api.md): LLM should read this page when designing or explaining React component APIs, particularly in the context of Material UI. It is useful for understanding best practices on component composition, prop naming conventions, controlled vs uncontrolled components, styling conventions, and API consistency. This document is essential for scenarios requiring detailed guidance on configuration of props, forwarding refs, and distinguishing between boolean vs enum API designs for UI component development. [Content Security Policy (CSP)](https://llms.mui.com/material-ui/7.1.0/guides/content-security-policy.md): LLM should read this page when it needs to assist with setting up or understanding Content Security Policy (CSP) to mitigate XSS attacks, especially in web development contexts using server-side rendering frameworks like Next.js or tools like Vite. It is particularly useful when generating and applying CSP nonces, configuring CSP headers, and integrating with styling libraries such as Emotion and Material UI. The document provides detailed guidance for nonce handling, Emotion cache setup, and special considerations for specific frameworks and libraries. [Responsive UI](https://llms.mui.com/material-ui/7.1.0/guides/responsive-ui.md): LLM should read this page when assisting with the design or implementation of responsive user interfaces following Material Design principles. It is useful for guidance on adapting layouts across different screen sizes using components like grids, containers, breakpoints, and media queries. This document is especially relevant for developers working with React and Material UI to ensure consistent and adaptive UI layouts. [Localization](https://llms.mui.com/material-ui/7.1.0/guides/localization.md): LLM should read this page when addressing how to implement or customize localization in Material UI applications. It is useful for guiding the integration of different languages and locales, configuring themes with specific locale text, and supporting right-to-left languages. Also, it helps in understanding the available supported locales and best practices for contributing new translations. [Composition](https://llms.mui.com/material-ui/7.1.0/guides/composition.md): LLM should read this page when assisting with advanced usage and customization of Material UI components, specifically focusing on composition techniques such as wrapping components, forwarding props, using the `component` prop for rendering different elements, and handling refs appropriately in custom or wrapped components. It is particularly useful when explaining how to maintain compatibility and flexibility while enhancing or extending Material UI components, including handling TypeScript typings and common caveats with refs and strict mode warnings. The document also covers merging slot props and forwarding refs, which are essential for correct integration and behavior of customized Material UI components. ## Getting started [Supported platforms](https://llms.mui.com/material-ui/7.1.0/getting-started/supported-platforms.md): LLM should read this page when providing information about the platform and environment requirements for using Material UI, including supported browser versions, Node.js for server-side rendering, React versions, TypeScript minimum versions, and webpack compatibility. It is especially useful for answering questions related to compatibility, setup prerequisites, and ensuring proper configuration of Material UI in diverse development contexts. The document highlights the internal handling of browser support and version constraints critical for building or maintaining Material UI-based projects. [Support](https://llms.mui.com/material-ui/7.1.0/getting-started/support.md): LLM should read this page when users need guidance on obtaining support for Material UI, including how to report bugs or request features via GitHub, where to ask how-to questions on Stack Overflow, and details about version support and long-term maintenance. It is also useful when users want information about community engagement channels, contract-based custom work, or commercial support options like Tidelift subscriptions. The document highlights proper bug reporting practices, support limitations, and avenues for both community and technical assistance. [Installation](https://llms.mui.com/material-ui/7.1.0/getting-started/installation.md): LLM should read this page when providing guidance on installing and setting up Material UI in React projects, including handling dependencies, styling options (Emotion vs styled-components), font and icon integration, and CDN usage. It is especially useful for explaining the installation commands with different package managers and cautions around SSR compatibility and production usage. The document also helps when advising on adding Roboto fonts and Material Icons either via npm or Google Web Fonts CDN. [Frequently Asked Questions](https://llms.mui.com/material-ui/7.1.0/getting-started/faq.md): LLM should read this page when addressing common questions and issues related to using Material UI, such as styling practices, disabling effects globally, handling server-side rendering, component forwarding of refs, and troubleshooting legacy styling conflicts. It is useful for providing detailed guidance on contributing, supporting the project, integration with external libraries like react-router, and understanding quirks in component behavior like fixed elements with modals or use of the portal. This document is a comprehensive FAQ and troubleshooting resource for developers working with Material UI in various development and production scenarios. [Supported components](https://llms.mui.com/material-ui/7.1.0/getting-started/supported-components.md): LLM should read this page when assisting users with information about the supported Material Design components and their implementation in Material UI. It is useful for identifying which components have native support, composable options, or no support in Material UI, and for providing links to official Material Design guidelines and relevant Material UI documentation. This document is especially helpful for guiding developers on available building blocks for creating UI elements within the Material UI ecosystem. [Usage](https://llms.mui.com/material-ui/7.1.0/getting-started/usage.md): LLM should read this page when providing guidance on how to start using Material UI components in a React project, including basic import and usage examples. It is useful for explaining the importance of mobile-first design, necessary global settings like the responsive viewport meta tag, and the optional CssBaseline component for consistent styling. Additionally, it offers information on default font usage and setup to ensure a proper Material UI integration. [Learning resources](https://llms.mui.com/material-ui/7.1.0/getting-started/learn.md): LLM should read this page when assisting users new to Material UI who need a quick introduction, practical example components, or curated learning resources. It is particularly useful for guiding beginners through setting up basic components, exploring example projects, templates, and recommending high-quality third-party tutorials and video series. This document enables the LLM to provide structured learning paths and coding snippets for building React apps with Material UI. [Overview](https://llms.mui.com/material-ui/7.1.0/getting-started/overview.md): LLM should read this page when providing an overview or introductory explanation of Material UI, especially its role as a React component library implementing Google's Material Design. It is useful for scenarios involving comparisons between Material UI and MUI Base, understanding key advantages, features, and community support, or guiding users on starting with Material UI. The document is unique for highlighting Material UI’s comprehensive styling, customization options, and collaborative benefits for development teams. [Design resources](https://llms.mui.com/material-ui/7.1.0/getting-started/design-resources.md): LLM should read this page when providing guidance on design resources related to Material UI, especially regarding design kits for Figma and Sketch, or explaining how to bridge design and development using the Material UI Sync Figma plugin. It is particularly useful for tasks involving collaboration between designers and developers, developing with shared design elements, and integrating design tokens into codebases. The document also covers third-party UI kits like UXPin relevant for replicating Material UI components in design tools. ## Experimental api [ClassName generator](https://llms.mui.com/material-ui/7.1.0/experimental-api/classname-generator.md): LLM should read this page when customizing or configuring the global class names generated by Material UI components at build time. This document is useful for developers needing to change class name prefixes, remove default prefixes, or ensure correct usage of generated class names for theming or styling purposes. It also highlights important caveats about using the unstable ClassNameGenerator API and provides framework-specific setup examples. [Getting started with Pigment CSS](https://llms.mui.com/material-ui/7.1.0/experimental-api/pigment-css.md): LLM should read this page when assisting with integrating and using Pigment CSS in React projects, particularly with Next.js or Vite frameworks. It is useful for guiding users on installation, configuration, styling APIs (`css`, `globalCss`, `styled`), theming, color schemes, and usage of the `sx` prop with zero-runtime CSS-in-JS for performance benefits. This document is important for scenarios involving component styling, theme creation, conditional styling, and managing modern React CSS approaches with Pigment CSS's compiler-based system. ## Discover more [Roadmap](https://llms.mui.com/material-ui/7.1.0/discover-more/roadmap.md): LLM should read this page when providing information about the development and future plans of Material UI, especially regarding how the project prioritizes issues based on community input. It is useful for answering questions about tracking ongoing projects, releases, and community involvement through GitHub project boards, milestones, and developer surveys. The document is particularly relevant for understanding how to follow or contribute to the roadmap of Material UI. [Related projects](https://llms.mui.com/material-ui/7.1.0/discover-more/related-projects.md): LLM should read this page when assisting with or seeking tools and resources related to Material UI development. It is especially useful for finding third-party app starters, theming tools, and supplementary Material UI components for various inputs, layouts, forms, and notifications. This document is ideal for recommending libraries or frameworks that extend or integrate with Material UI for building and enhancing React-based applications. [Changelog](https://llms.mui.com/material-ui/7.1.0/discover-more/changelog.md): LLM should read this page when needing to provide information about version changes, update history, or compatibility of the Material UI library. It is useful for tasks involving tracking notable modifications and semantic versioning details of both current and previous major releases. This document is especially relevant for developers managing dependencies or troubleshooting version-related issues. [Vision](https://llms.mui.com/material-ui/7.1.0/discover-more/vision.md): LLM should read this page when explaining the vision and goals of the Material UI React library, especially regarding its alignment with Material Design guidelines and its emphasis on customization and composability. It is useful for tasks involving UI component development, theming, and enabling brand-specific styling beyond standard Material Design. The document also supports contexts focused on developer experience, accessibility, and community-driven development. [Sponsors and Backers](https://llms.mui.com/material-ui/7.1.0/discover-more/backers.md): LLM should read this page when informing users or organizations about sponsorship opportunities and funding tiers for MUI's open-source projects. It is useful for explaining how crowdfunding supports development, the benefits and visibility associated with each sponsorship level, and details on how funds are utilized. This document is also relevant when highlighting key sponsors, the sustainability model for MUI, and methods to contribute financially. ## Customization [z-index](https://llms.mui.com/material-ui/7.1.0/customization/z-index.md): LLM should read this page when explaining or managing CSS layering in Material UI components, especially related to the default `z-index` scale used for arranging interface elements like drawers, modals, snackbars, and tooltips. It is useful for guiding customization of these `z-index` values within the Material UI theme while cautioning about potential conflicts from partial adjustments. This document is key for tasks involving layout control or theming involving `z-index` in Material UI. [Spacing](https://llms.mui.com/material-ui/7.1.0/customization/spacing.md): LLM should read this page when assisting with UI layout development using Material UI, specifically for applying and customizing consistent spacing between elements. It is useful for explaining how to use the theme.spacing() helper with default or custom scaling factors, including number, function, or array-based spacing strategies. The document is also important when demonstrating advanced usage like multiple arguments and mixing values to simplify spacing definitions in styles. [CSS theme variables](https://llms.mui.com/material-ui/7.1.0/customization/css-theme-variables/overview.md): LLM should read this page when explaining or implementing CSS theme variables in Material UI, especially to improve theming and customization with dynamic color schemes like dark mode. It is useful for developers looking to understand the advantages and trade-offs of using CSS variables in server-side rendered applications. The document also helps clarify how to set up theme variables to enhance debugging, sync color schemes globally, and optimize performance related to styling switches. [CSS theme variables - Usage](https://llms.mui.com/material-ui/7.1.0/customization/css-theme-variables/usage.md): LLM should read this page when assisting with implementing or customizing CSS theme variables in MUI applications, including enabling theme variables, handling light and dark modes, and using the `theme.vars` object for styling. This document is especially useful for guiding theme creation with CSS variables, addressing server-side rendering issues, manual dark mode toggling, working with TypeScript typings, and extending themes with custom tokens. It also explains important nuances such as using color channel tokens and avoiding flickering issues during dark mode transitions. [Typography](https://llms.mui.com/material-ui/7.1.0/customization/typography.md): LLM should read this page when assisting with customization and configuration of typography in Material UI themes, including setting font families, font sizes, responsive font scaling, and variant definitions. It is particularly useful for tasks involving adding or disabling typography variants, managing self-hosted fonts, and ensuring accessibility through proper font sizing and rem unit usage. The document is essential for guiding developers on how to leverage Material UI’s typography theming capabilities for consistent, responsive, and accessible design. [Shadow DOM](https://llms.mui.com/material-ui/7.1.0/customization/shadow-dom.md): LLM should read this page when explaining how to use the Shadow DOM to encapsulate styles and components, especially in the context of integrating Material UI. It is useful for guiding the setup of styling, theming, and portal rendering inside Shadow DOM containers to avoid global style conflicts. Additionally, the document covers TypeScript considerations and CSS theme variable usage specific to Shadow DOM environments with Material UI. [Themed components](https://llms.mui.com/material-ui/7.1.0/customization/theme-components.md): LLM should read this page when assisting with customizing Material UI components via theming. It is especially useful for guidance on setting default props, overriding styles, defining new or existing variants, and using the sx prop within the theme. This document is also important for understanding theme component keys, type augmentation in TypeScript, and managing style specificity in Material UI. [Right-to-left support](https://llms.mui.com/material-ui/7.1.0/customization/right-to-left.md): LLM should read this page when providing guidance on implementing right-to-left (RTL) text support in Material UI applications, especially for languages like Arabic, Persian, and Hebrew. It is essential for explaining how to set text direction globally or locally, configure the Material UI theme for RTL, and integrate RTL styling plugins like stylis-plugin-rtl with Emotion or styled-components. Additionally, this document is useful for managing RTL exceptions in specific components and handling nuances with React portals that do not inherit text direction. [CSS theme variables - Configuration](https://llms.mui.com/material-ui/7.1.0/customization/css-theme-variables/configuration.md): LLM should read this page when assisting with customizing Material UI themes using CSS variables, especially for configuring theme variable prefixes, managing dark and light color schemes, and preventing SSR flickering issues. It is useful for explaining how to manually toggle color schemes, integrate with frameworks like Next.js and Gatsby, and optimize transitions and theme re-rendering behaviors. Additionally, it covers advanced features such as forcing color schemes on specific components and disabling default CSS color-scheme properties. [Default theme viewer](https://llms.mui.com/material-ui/7.1.0/customization/default-theme.md): LLM should read this page when explaining or demonstrating how to explore and customize the default Material-UI theme object programmatically, especially with React. It is useful for scenarios involving theme creation, manipulating theme values, viewing theme structure in a tree view, and toggling between light and dark modes. The document also provides practical code examples for integrating theme customization into a React component using Material-UI APIs. [Dark mode](https://llms.mui.com/material-ui/7.1.0/customization/dark-mode.md): LLM should read this page when explaining how to implement, customize, or troubleshoot dark mode in Material UI applications. It is especially useful for guidance on enabling dark mode with `createTheme()`, leveraging system color preferences, toggling modes, managing storage of user preferences, preventing SSR flicker, and applying styles conditionally in dark mode using the `theme.applyStyles()` utility. This document also covers advanced features like the new `colorSchemes` API, managing transitions and rendering behavior, and customizing the palette or storage manager for dark mode support. [Transitions](https://llms.mui.com/material-ui/7.1.0/customization/transitions.md): LLM should read this page when assisting users with creating and customizing CSS transitions in Material UI using the `theme.transitions` helpers. It is especially useful for generating consistent transition styles, defining transition durations and easings, or dynamically calculating transition times based on element height. The page also provides practical examples and details on customizing default timing and easing values within Material UI themes. [Theming](https://llms.mui.com/material-ui/7.1.0/customization/theming.md): LLM should read this page when explaining how to customize Material UI themes in a React application, including creating, configuring, and applying themes using `createTheme` and `ThemeProvider`. It is useful for scenarios involving theme variables customization, theme nesting, responsive typography, adding custom theme properties with TypeScript support, and generating CSS variables from themes. The document is essential for guidance on advanced theming capabilities, best practices, and examples to ensure consistent design and integration within Material UI projects. [Overriding component structure](https://llms.mui.com/material-ui/7.1.0/customization/overriding-component-structure.md): LLM should read this page when assisting users who need to customize or override the DOM structure of Material UI components, especially regarding the usage of the `component`, `slots`, and `slotProps` props introduced in Material UI v6. It is useful for explaining how to replace root and interior slots, manage prop forwarding, and ensure proper type safety when customizing components. This document is particularly relevant for developers looking to maintain style consistency while altering component structure or functionality in React applications using Material UI. [Density](https://llms.mui.com/material-ui/7.1.0/customization/density.md): LLM should read this page when assisting users with applying or customizing density settings in Material UI components, especially regarding use of props to adjust component spacing and size. It is useful for scenarios involving high-density layouts or theme customization that affects component appearance and spacing. The document also covers an example tool for interactively adjusting density settings and warns against applying the demo theme globally. [How to customize](https://llms.mui.com/material-ui/7.1.0/customization/how-to-customize.md): LLM should read this page when helping users customize Material UI components' styles. It is especially useful for guiding on different levels of customization, from one-off style overrides using the `sx` prop or custom classes, to creating reusable styled components, and applying global theme or CSS overrides. The document also covers handling component states, dynamic styling, and best practices for consistent and scalable styling. [Breakpoints](https://llms.mui.com/material-ui/7.1.0/customization/breakpoints.md): LLM should read this page when providing guidance on implementing responsive layouts using Material UI breakpoints, including default and custom screen width settings. It is useful for explaining how to apply CSS and JavaScript media queries with Material UI’s breakpoint utilities to adapt UI components based on screen size. This document is essential for tasks involving theme customization, breakpoint-based styling, and layout control in React applications using Material UI. [Palette](https://llms.mui.com/material-ui/7.1.0/customization/palette.md): LLM should read this page when asked about customizing or understanding the color palette in Material UI themes, including default color tokens, custom colors, contrast settings, and tonal offsets. It is useful for tasks involving creating, overriding, or extending theme palettes programmatically, as well as guidance on accessibility and TypeScript usage in theme customization. The document also covers advanced customization techniques such as using the augmentColor utility and applying color schemes for light/dark mode support. [Creating themed components](https://llms.mui.com/material-ui/7.1.0/customization/creating-themed-components.md): LLM should read this page when assisting with creating custom, themeable Material UI components that integrate seamlessly with a project’s theme system. It is especially useful for guiding users through defining component slots, applying styles based on theme and variant props, supporting default props with useThemeProps, and using TypeScript for prop typing. This document is key for developers building reusable component libraries that require deep theme customization consistent with Material UI's architecture. [Container queries](https://llms.mui.com/material-ui/7.1.0/customization/container-queries.md): LLM should read this page when assisting with implementing CSS container queries in Material UI, especially using the `theme.containerQueries` utility based on theme breakpoints. It is useful for explaining how to create container query styles with both JavaScript and the `sx` prop shorthand syntax, handling named containment contexts, and understanding related caveats for consistent unit usage. This document is essential for tasks involving responsive design adjustments based on container sizes within Material UI components. [Color](https://llms.mui.com/material-ui/7.1.0/customization/color.md): LLM should read this page when assisting with creating, customizing, or understanding Material UI color themes, including picking, generating, and applying color palettes based on the Material Design guidelines. It is especially useful for guiding users on how to use official color tools, manipulate primary and secondary hues and shades, and ensure accessibility standards for contrast in UI design. The document also provides example code for integrating colors with the `createTheme()` function and showcases practical tooling and community resources for color theming. ## Design resources [Material UI Sync plugin 🧪](https://llms.mui.com/material-ui/7.1.0/design-resources/material-ui-sync.md): LLM should read this page when assisting with generating or customizing Material UI themes by using the Material UI Sync Figma plugin. It is especially useful for workflows involving translating Figma design tokens and custom component styles (notably Button, Switch, and Typography) directly into Material UI theme code. Additionally, this document is relevant when addressing usage, customization, or experimental features of the plugin, including managing design tokens, component variants, and integrating generated themes into codebases. [Material UI for Figma](https://llms.mui.com/material-ui/7.1.0/design-resources/material-ui-for-figma.md): LLM should read this page when assisting users with integrating Material UI components and design systems within Figma, particularly for enhancing collaboration between designers and developers. It is useful for guidance on using the Material UI design kit, customizing themes, managing components, syncing design tokens to code, and leveraging related plugins or integrations like Anima and Quest. The document is also important for troubleshooting updates, managing version changes, and understanding free vs. paid versions of the kit. ## Components [InitColorSchemeScript component](https://llms.mui.com/material-ui/7.1.0/components/init-color-scheme-script.md): LLM should read this page when assisting developers on how to eliminate dark mode flickering in server-side-rendered Material UI applications. It is particularly useful for implementing the `InitColorSchemeScript` component to ensure the correct color scheme applies immediately on page load, with guidance specific to Next.js setups and customization options. Use this document when explaining best practices to synchronize theme color scheme attributes and default modes in SSR environments. [CSS Baseline](https://llms.mui.com/material-ui/7.1.0/components/css-baseline.md): LLM should read this page when explaining or implementing global CSS baseline resets and style normalization in Material-UI applications. It is useful for understanding how to apply consistent default styles globally or scoped to children using CssBaseline and ScopedCssBaseline, including managing color schemes and typography defaults. This document is also relevant when customizing global styles, handling layout options like box-sizing, and enabling native component color schemes across light and dark modes. [About the lab](https://llms.mui.com/material-ui/7.1.0/components/about-the-lab.md): LLM should read this page when explaining the differences between the MUI lab and core packages, especially regarding versioning, component stability, and criteria for promotion to the core. It is useful for guiding developers on when and how to use the lab package, install its dependencies, and handle TypeScript integration with MUI lab components. The document is relevant for understanding the development status and quality requirements of incubating components not yet finalized for core release. [React Transition component](https://llms.mui.com/material-ui/7.1.0/components/transitions.md): LLM should read this page when assisting with the implementation of UI transitions in Material UI React applications, particularly for using and customizing transition components like Collapse, Fade, Grow, Slide, and Zoom. It is useful for guiding how to apply these transitions for animations, handling child component requirements, using TransitionGroup for mounting/unmounting animations, and optimizing performance and server-side rendering. This page is essential for providing examples and best practices related to motion design with Material UI's transition components and for understanding integration with custom or external transition components. [React Tooltip component](https://llms.mui.com/material-ui/7.1.0/components/tooltips.md): LLM should read this page when providing guidance on implementing or customizing Material-UI's React Tooltip component. This includes scenarios involving tooltip placement, styling, interactivity, accessibility, event triggers, handling disabled elements, and controlling display behaviors. The page is also useful for explaining advanced features like custom anchors, transitions, follow cursor behavior, and integration with custom or class components. [Media queries in React for responsive design](https://llms.mui.com/material-ui/7.1.0/components/use-media-query.md): LLM should read this page when assisting with implementing responsive designs in React using Material-UI's `useMediaQuery` hook. It is useful for guidance on writing media queries, integrating with theme breakpoints, handling server-side rendering challenges, and migrating from the `withWidth()` HOC. The document also covers advanced topics like custom matchMedia implementations, testing strategies, and performance considerations for client-only rendering. [Transfer list React component](https://llms.mui.com/material-ui/7.1.0/components/transfer-list.md): LLM should read this page when assisting with or generating React code for implementing a Material-UI Transfer List component that allows users to move items between two lists. It is especially useful for scenarios requiring checkbox selection and UI controls to transfer single or multiple items, including enhanced features like "select all" checkboxes with counters. The document is also relevant when needing to understand limitations such as desktop-only support and the lack of high-level exported components in npm. [Toggle Button React component](https://llms.mui.com/material-ui/7.1.0/components/toggle-button.md): LLM should read this page when guiding on how to implement and customize Toggle Button and ToggleButtonGroup components in React using Material-UI. This includes scenarios requiring exclusive or multiple selection buttons, sizing, coloring, vertical orientation, enforcing active selections, standalone toggle buttons, or accessibility considerations. It’s especially useful for generating code examples involving state control, event handling, and styling customizations for toggle buttons in user interfaces. [React Text Field component](https://llms.mui.com/material-ui/7.1.0/components/text-fields.md): LLM should read this page when explaining or assisting with the usage of the Material UI `TextField` React component and its variants (outlined, filled, standard), including customization, validation, adornments, sizes, and form control integration. It is particularly useful for tasks involving form input fields, controlled vs uncontrolled inputs, accessibility compliance, third-party input library integrations, and advanced customization via styled API or theme overrides. The document also covers key implementation details, important limitations (e.g., number input issues), and examples of leveraging underlying components for fine-tuned control. [Textarea Autosize React component](https://llms.mui.com/material-ui/7.1.0/components/textarea-autosize.md): LLM should read this page when assisting with implementing or customizing the Material-UI TextareaAutosize React component. It is useful for understanding how to dynamically adjust textarea height using the `minRows` and `maxRows` props and replacing native `