mui / mui/material-ui

Modernize Default MUI Shadows / Add Theme Shadow Options

Open
#48,760 14 comments 3 reactions 1 assignee View on GitHub

@siriwatknp is already working on this.

Since Jul 4, 2026.

customization: theme scope: system waiting for 👍
Dominant language
JavaScript
Stars
99.1k
Forks
32.5k
Avg merge
2d 17h
Merged PRs (30d)
106

Description

Summary

The default Material UI box shadows feel dated and don't match the cleaner, flatter aesthetic of modern applications. They often make the UI look heavier than necessary.

I'd like one of the following improvements:

  • Update the default MUI shadow system to use more modern, subtle shadows.
  • Alternatively, provide an easy way to switch between multiple built-in shadow themes (e.g. Classic, Modern, Flat, Soft, Material 3) through the theme configuration, similar to how color palettes can be customized.

This would make it much easier for developers to achieve a contemporary look without overriding shadows throughout their application.

Examples

Many modern design systems, including Material Design 3, use softer, lower-contrast shadows. Providing built-in shadow presets would allow applications to easily adopt different visual styles without overriding the entire theme.shadows array.

Motivation

Shadows are one of the most noticeable aspects of an application's visual design. While MUI already makes colors, typography, and spacing easy to customize, shadows still require replacing the entire shadow array. Built-in shadow themes or a modern default would improve aesthetics and reduce customization effort.

Search keywords: modern box shadow theme

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.