Foundations
Depth
depth-raised
depth-raised-fill
depth-floating
depth-panel
depth-showcase
Every shadow recipe does three jobs:
- a 0.5px spread ring draws the edge,
- a 1px contact shadow shows where the surface meets the page, and
- a soft ambient layer lifts it.
| Token | Use |
|---|---|
depth-raised / -hover |
Outline and secondary buttons, raised chips. Hover grows only the ambient layer, because the control hasn't moved |
depth-raised-fill / -hover |
Solid primary buttons. A cast shadow only: no ring and no white top highlight, which would read as a grey seam |
depth-floating |
Menus, popovers, floating toolbars |
depth-panel |
The app's main content panel: five faint layers, each doubling the offset of the one before |
depth-showcase |
Marketing frames only |
Rules:
- Light shadows use a warm near-black (
rgb(61 59 53)), never neutral black. A grey shadow on white reads as dirt, and a warm one reads as light. - Transparent (ghost) controls have no shadow.
- Press: move down 1px and drop the shadow, so the gap closes.
- Disabled: 50% opacity and no shadow.
- Dark: a white ring at 6–10% plus one black contact shadow. Hover brightens the ring instead of adding blur. Floating layers keep a deep black ambient shadow.
- On sparse marketing pages, control shadows look like grime, so buttons there are flat.
Tokens
--depth-raised, --depth-raised-hover, --depth-raised-fill, --depth-raised-fill-hover, --depth-floating, --depth-panel, --depth-showcase, and --shadow-tone (the warm near-black).