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.

Base
material-baserounded-md

The resting surface: hairline border, no shadow. Equivalent to what card and input draw by hand.

Small
material-smallrounded-md

A subtle lift for small panels that must separate from a busy background.

Medium
material-mediumrounded-xl

Raised in-page content: feature panels and hover-lifted tiles.

Large
material-largerounded-xl

The 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.

Tooltip
material-tooltiprounded-md

The lightest floating material: tooltips and chart tooltips, sized to a single label.

Menu
material-menurounded-md

Dropdown and context menus, selects, comboboxes.

Modal
material-modalrounded-xl

Dialogs, drawers, sheets and toasts: anything that takes focus from the page.

Fullscreen
material-fullscreenrounded-xl

The 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: base and small for resting surfaces, medium and large for raised content, tooltip and menu for popovers, modal and fullscreen for takeovers. In the component library, menu and modal do 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-index band, so a tooltip-typed surface never renders visually beneath a base card.
  • 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.

Go to a page

Search every page in the navigation.