# mui/material-ui architecture

> Architecture diagram of the GitHub repository mui/material-ui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mui/material-ui
- Repository: https://github.com/mui/material-ui

## Overview

Material UI is a React component library, with related packages for icons, theming, advanced components, framework integration, and documentation. The main user workflow is importing components and hooks into a React application, configuring theme and behavior, and rendering interactive UI; Next.js adapters support server-rendered styling. The graph also preserves documented documentation and migration capabilities. Source excerpts are selective, so edges are limited to relationships shown in excerpts or the SOURCE INDEX; unsampled subsystems are represented without inferred call chains.

Main entry points: [`packages/mui-material/src/useAutocomplete/useAutocomplete.js`](https://github.com/mui/material-ui/blob/master/packages/mui-material/src/useAutocomplete/useAutocomplete.js) (Autocomplete hook), [`packages-internal/core-docs/src/DocsApp/DocsApp.tsx`](https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/DocsApp/DocsApp.tsx) (Documentation app), [`packages/mui-utils/src/useRovingTabIndex/useRovingTabIndex.ts`](https://github.com/mui/material-ui/blob/master/packages/mui-utils/src/useRovingTabIndex/useRovingTabIndex.ts) (Roving tab index), [`packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13App.tsx`](https://github.com/mui/material-ui/blob/master/packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13App.tsx) (Next Pages adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_components["React components"]
  node_autocomplete["Autocomplete hook<br/>[useAutocomplete.js]"]
  node_slider["Slider behavior<br/>[useSlider.ts]"]
  node_buttonbase["Button behavior<br/>[useButtonBase.ts]"]
  node_snackbar["Snackbar behavior<br/>[useSnackbar.ts]"]
  node_modal["Modal management<br/>[ModalManager.ts]"]
end

subgraph group_foundations["Theme and utilities"]
  node_theme["Theme context<br/>[ThemeContext.tsx]"]
  node_media["Media query hook<br/>[useMediaQuery.ts]"]
  node_themeprops["Theme props<br/>[useThemeProps.ts]"]
  node_private_theme["Private theme hook<br/>[useTheme.ts]"]
  node_roving["Roving tab index"]
  node_roving_context["Tab index context"]
  node_controlled["Controlled state<br/>[useControlled.ts]"]
end

subgraph group_framework["Framework integration"]
  node_next_pages["Next Pages adapter"]
  node_next_document["Next document styles"]
  node_next_app["Next App Router<br/>[appRouterV13.tsx]"]
end

subgraph group_docs["Documentation"]
  node_docs_app["Documentation app<br/>[DocsApp.tsx]"]
  node_api_docs["API documentation<br/>[ApiPage.tsx]"]
  node_demos["Interactive demos<br/>[DemoController.tsx]"]
end

subgraph group_ecosystem["Related packages"]
  node_icons["Material icons<br/>[Engineering.js]"]
  node_icon_factory["SVG icon factory<br/>[createSvgIcon.js]"]
  node_lab["Lab components<br/>[TabContext.tsx]"]
  node_codemod["Migration transforms<br/>[codemod.js]"]
end

node_developer(("React developer"))
node_app["React application"]

node_developer -->|"builds with"| node_app
node_app -->|"uses hook"| node_autocomplete
node_app -->|"uses behavior"| node_slider
node_autocomplete -->|"manages state"| node_controlled
node_autocomplete -.->|"supports navigation"| node_roving
node_roving -->|"uses context"| node_roving_context
node_media -->|"reads theme props"| node_themeprops
node_private_theme -.->|"uses theme context"| node_theme
node_app -->|"integrates with"| node_next_pages
node_next_document -->|"enhances app"| node_next_pages
node_app -->|"integrates with"| node_next_app
node_icons -->|"creates icon"| node_icon_factory
node_developer -->|"consults docs"| node_docs_app
node_docs_app -.->|"presents API"| node_api_docs
node_docs_app -.->|"presents demos"| node_demos
node_developer -.->|"migrates code"| node_codemod

click node_autocomplete "https://github.com/mui/material-ui/blob/master/packages/mui-material/src/useAutocomplete/useAutocomplete.js"
click node_slider "https://github.com/mui/material-ui/blob/master/packages/mui-material/src/Slider/useSlider.ts"
click node_buttonbase "https://github.com/mui/material-ui/blob/master/packages/mui-material/src/ButtonBase/useButtonBase.ts"
click node_snackbar "https://github.com/mui/material-ui/blob/master/packages/mui-material/src/Snackbar/useSnackbar.ts"
click node_modal "https://github.com/mui/material-ui/blob/master/packages/mui-material/src/Modal/ModalManager.ts"
click node_theme "https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/ThemeContext/ThemeContext.tsx"
click node_media "https://github.com/mui/material-ui/blob/master/packages/mui-system/src/useMediaQuery/useMediaQuery.ts"
click node_themeprops "https://github.com/mui/material-ui/blob/master/packages/mui-system/src/useThemeProps/useThemeProps.ts"
click node_private_theme "https://github.com/mui/material-ui/blob/master/packages/mui-private-theming/src/useTheme/useTheme.ts"
click node_roving "https://github.com/mui/material-ui/blob/master/packages/mui-utils/src/useRovingTabIndex/useRovingTabIndex.ts"
click node_roving_context "https://github.com/mui/material-ui/blob/master/packages/mui-utils/src/useRovingTabIndex/RovingTabIndexContext.tsx"
click node_controlled "https://github.com/mui/material-ui/blob/master/packages/mui-utils/src/useControlled/useControlled.ts"
click node_next_pages "https://github.com/mui/material-ui/blob/master/packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13App.tsx"
click node_next_document "https://github.com/mui/material-ui/blob/master/packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13Document.tsx"
click node_next_app "https://github.com/mui/material-ui/blob/master/packages/mui-material-nextjs/src/v13-appRouter/appRouterV13.tsx"
click node_docs_app "https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/DocsApp/DocsApp.tsx"
click node_api_docs "https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/ApiPage/ApiPage.tsx"
click node_demos "https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/DemoContent/DemoController.tsx"
click node_icons "https://github.com/mui/material-ui/blob/master/packages/mui-icons-material/lib/Engineering.js"
click node_icon_factory "https://github.com/mui/material-ui/blob/master/packages/mui-icons-material/lib/utils/createSvgIcon.js"
click node_lab "https://github.com/mui/material-ui/blob/master/packages/mui-lab/src/TabContext/TabContext.tsx"
click node_codemod "https://github.com/mui/material-ui/blob/master/packages/mui-codemod/src/codemod.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_autocomplete,node_slider,node_buttonbase,node_snackbar,node_modal toneBlue
class node_theme,node_media,node_themeprops,node_private_theme,node_roving,node_roving_context,node_controlled toneAmber
class node_next_pages,node_next_document,node_next_app toneMint
class node_docs_app,node_api_docs,node_demos toneRose
class node_icons,node_icon_factory,node_lab,node_codemod,node_developer,node_app toneIndigo
```

## Components

### React components

- [Autocomplete hook](https://github.com/mui/material-ui/blob/master/packages/mui-material/src/useAutocomplete/useAutocomplete.js): `packages/mui-material/src/useAutocomplete/useAutocomplete.js`
- [Slider behavior](https://github.com/mui/material-ui/blob/master/packages/mui-material/src/Slider/useSlider.ts): `packages/mui-material/src/Slider/useSlider.ts`
- [Button behavior](https://github.com/mui/material-ui/blob/master/packages/mui-material/src/ButtonBase/useButtonBase.ts): `packages/mui-material/src/ButtonBase/useButtonBase.ts`
- [Snackbar behavior](https://github.com/mui/material-ui/blob/master/packages/mui-material/src/Snackbar/useSnackbar.ts): `packages/mui-material/src/Snackbar/useSnackbar.ts`
- [Modal management](https://github.com/mui/material-ui/blob/master/packages/mui-material/src/Modal/ModalManager.ts): `packages/mui-material/src/Modal/ModalManager.ts`

### Theme and utilities

- [Theme context](https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/ThemeContext/ThemeContext.tsx): `packages-internal/core-docs/src/ThemeContext/ThemeContext.tsx`
- [Media query hook](https://github.com/mui/material-ui/blob/master/packages/mui-system/src/useMediaQuery/useMediaQuery.ts): `packages/mui-system/src/useMediaQuery/useMediaQuery.ts`
- [Theme props](https://github.com/mui/material-ui/blob/master/packages/mui-system/src/useThemeProps/useThemeProps.ts): `packages/mui-system/src/useThemeProps/useThemeProps.ts`
- [Private theme hook](https://github.com/mui/material-ui/blob/master/packages/mui-private-theming/src/useTheme/useTheme.ts): `packages/mui-private-theming/src/useTheme/useTheme.ts`
- [Roving tab index](https://github.com/mui/material-ui/blob/master/packages/mui-utils/src/useRovingTabIndex/useRovingTabIndex.ts): `packages/mui-utils/src/useRovingTabIndex/useRovingTabIndex.ts`
- [Tab index context](https://github.com/mui/material-ui/blob/master/packages/mui-utils/src/useRovingTabIndex/RovingTabIndexContext.tsx): `packages/mui-utils/src/useRovingTabIndex/RovingTabIndexContext.tsx`
- [Controlled state](https://github.com/mui/material-ui/blob/master/packages/mui-utils/src/useControlled/useControlled.ts): `packages/mui-utils/src/useControlled/useControlled.ts`

### Framework integration

- [Next Pages adapter](https://github.com/mui/material-ui/blob/master/packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13App.tsx): `packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13App.tsx`
- [Next document styles](https://github.com/mui/material-ui/blob/master/packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13Document.tsx): `packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13Document.tsx`
- [Next App Router](https://github.com/mui/material-ui/blob/master/packages/mui-material-nextjs/src/v13-appRouter/appRouterV13.tsx): `packages/mui-material-nextjs/src/v13-appRouter/appRouterV13.tsx`

### Documentation

- [Documentation app](https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/DocsApp/DocsApp.tsx): `packages-internal/core-docs/src/DocsApp/DocsApp.tsx`
- [API documentation](https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/ApiPage/ApiPage.tsx): `packages-internal/core-docs/src/ApiPage/ApiPage.tsx`
- [Interactive demos](https://github.com/mui/material-ui/blob/master/packages-internal/core-docs/src/DemoContent/DemoController.tsx): `packages-internal/core-docs/src/DemoContent/DemoController.tsx`

### Related packages

- [Material icons](https://github.com/mui/material-ui/blob/master/packages/mui-icons-material/lib/Engineering.js): `packages/mui-icons-material/lib/Engineering.js`
- [SVG icon factory](https://github.com/mui/material-ui/blob/master/packages/mui-icons-material/lib/utils/createSvgIcon.js): `packages/mui-icons-material/lib/utils/createSvgIcon.js`
- [Lab components](https://github.com/mui/material-ui/blob/master/packages/mui-lab/src/TabContext/TabContext.tsx): `packages/mui-lab/src/TabContext/TabContext.tsx`
- [Migration transforms](https://github.com/mui/material-ui/blob/master/packages/mui-codemod/src/codemod.js): `packages/mui-codemod/src/codemod.js`

### Other components

- **React developer**
- **React application**

## Connections

- React developer → React application: builds with (evidence: `README.md`)
- React application → Autocomplete hook: uses hook (evidence: `packages/mui-material/src/useAutocomplete/useAutocomplete.js`)
- React application → Slider behavior: uses behavior (evidence: `packages/mui-material/src/Slider/useSlider.ts`)
- Autocomplete hook → Controlled state: manages state (evidence: `packages/mui-material/src/useAutocomplete/useAutocomplete.js`)
- Autocomplete hook → Roving tab index: supports navigation
- Roving tab index → Tab index context: uses context (evidence: `packages/mui-utils/src/useRovingTabIndex/useRovingTabIndex.ts`)
- Media query hook → Theme props: reads theme props (evidence: `packages/mui-system/src/useMediaQuery/useMediaQuery.ts`)
- Private theme hook → Theme context: uses theme context
- React application → Next Pages adapter: integrates with (evidence: `README.md`)
- Next document styles → Next Pages adapter: enhances app (evidence: `packages/mui-material-nextjs/src/v13-pagesRouter/pagesRouterV13Document.tsx`)
- React application → Next App Router: integrates with (evidence: `README.md`)
- Material icons → SVG icon factory: creates icon (evidence: `packages/mui-icons-material/lib/Engineering.js`)
- React developer → Documentation app: consults docs (evidence: `README.md`)
- Documentation app → API documentation: presents API
- Documentation app → Interactive demos: presents demos
- React developer → Migration transforms: migrates code
