Materials
Elevation presets combining background, border, shadow, and radius.
Surface
Four levels of elevation for elements that sit in the page. Radius steps up with elevation.
In-page surfaces in the component library are flat by decision: cards, sidebars, inputs and wells draw a hairline border-gray-alpha-400 on bg-background-100 and carry no shadow, so no ui component uses a Surface material today. The tiers remain available for content that genuinely needs to lift off the page (marketing sections, dashboards, previews) and for consumers whose surfaces are not flat.
material-baserounded-mdThe resting surface: hairline border, no shadow. Equivalent to what card and input draw by hand.
material-smallrounded-mdA subtle lift for small panels that must separate from a busy background.
material-mediumrounded-xlRaised in-page content: feature panels and hover-lifted tiles.
material-largerounded-xlThe most elevated on-page surface.
Floating
Four levels of elevation for elements that float above the page, ordered from closest to furthest off the surface.
material-tooltiprounded-mdThe lightest floating material: tooltips and chart tooltips, sized to a single label.
material-menurounded-mdDropdown and context menus, selects, comboboxes.
material-modalrounded-xlDialogs, drawers, sheets and toasts: anything that takes focus from the page.
material-fullscreenrounded-xlThe highest elevation, reserved for fullscreen takeovers.
Best practices
When to use
- Reach for a material instead of composing background, border, shadow, and radius by hand. The class encodes the elevation role, not just the look.
- Pick the type from where the element sits in the layered hierarchy:
baseandsmallfor resting surfaces,mediumandlargefor raised content,tooltipandmenufor popovers,modalandfullscreenfor takeovers. In the component library,menuandmodaldo nearly all the work. - Never stack two materials on the same element. If a child needs more lift, it becomes its own material one tier up.
Behavior
- Keep the elevation choice in step with the element's
z-indexband, so atooltip-typed surface never renders visually beneath abasecard. - Favor the lowest tier that still reads as separated from its background; over-elevating is the most common source of visual noise.
- Don't override a material's shadow or radius inline. If a surface needs different chrome, it belongs to a different tier.
Accessibility
- Materials are decorative chrome. Semantics live on the role-bearing element:
role="dialog"on a modal,role="tooltip"on a tooltip, never on the class. - Elevation is never the only signal: pair floating surfaces with focus management, and keep the focus ring on interactive children inside.
- Check both themes. Dark shadows use higher opacities than light, yet still barely register against a black page; in dark, separation comes from the hairline ring, so verify it reads wherever the material lands.