# material-ui-theming

Guides Material UI theme creation and design tokens, including palettes, light and dark color schemes, and CSS theme variables.

Skill by MUI. Category: Design and frontend.

## Install

Project (for this project only):

```sh
npx skills add mui/material-ui --skill material-ui-theming
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add mui/material-ui --skill material-ui-theming -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 534. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/mui/material-ui/material-ui-theming)

## Source

[Open the source](https://github.com/mui/material-ui/tree/HEAD/skills/material-ui-theming). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: material-ui-theming
description: Guides Material UI theming and design tokens (createTheme, ThemeProvider, palette, colorSchemes, cssVariables, theme.vars, dark mode, TypeScript augmentation). Use when building or extending a theme, toggling light/dark, or aligning tokens across an app.
license: MIT
metadata:
  author: mui
  version: '1.0.0'
---

# Material UI theming and design tokens

Agent skill for theme creation, design tokens, light/dark, and CSS theme variables. SKILL.md is the entry; AGENTS.md is the full guide.

## When to apply

- `createTheme`, `ThemeProvider`, `useTheme`, `CssBaseline`
- `colorSchemes`, `useColorScheme`, storage / SSR behavior
- `cssVariables: true`, `theme.vars`, `applyStyles('dark', …)`
- Custom theme keys and TypeScript module augmentation

## Sections in AGENTS.md

| Area          | Topics                                                          |
| :------------ | :-------------------------------------------------------------- |
| Core setup    | Imports, provider placement, `useTheme`                         |
| Token map     | palette, typography, spacing, shape, breakpoints, components, … |
| Palette       | `main` / derived colors, `@mui/material/colors`, `mode`         |
| Color schemes | vs palette-only, hydration, `ThemeProvider` props               |
| CSS variables | `cssVariables`, reserved `vars`, flicker avoidance              |
| Composition   | Multi-step `createTheme`, `deepmerge`, nesting providers        |
| Custom tokens | Augmenting `Theme` / `ThemeOptions`                             |

## Full guide

Read [AGENTS.md](./AGENTS.md) for the complete instructions and links.

TypeScript snippets: [reference.md](./reference.md).
````

- Previous: [material-ui-styling](https://syn4pse.dev/terminal/material-ui-styling.md)
- Next: [material-ui-tailwind](https://syn4pse.dev/terminal/material-ui-tailwind.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
