Elevation
A short ladder of neutral surfaces drawn by hairlines; only what floats casts a shadow, and overlays blur rather than darken.
Depth
Depth is a short ladder of neutral surfaces drawn by hairlines; nothing lifts and nothing catches light.
The surfaces and their values are on Colors. In flow, everything is outline-only. Overlays add depth by blur rather than by black: a dialog's backdrop blurs the page by--backdrop-blur (8px) under a light scrim, and chrome that content scrolls under is glass (--glass with --glass-blur, 12px).
A raised surface is one you touch (the composer, a user's message, a settings group), a card frames code, and an elevated one floats (menus, trays, dialogs).
Shadows
Only floating things cast a shadow, and it is long and soft.
| Token | Use | Edge |
|---|---|---|
| Menus, popovers, hover cards, tooltips and toasts. | Float edge | |
| Dialogs and confirm dialogs: longer and deeper, because they sit highest. | Float edge | |
| Trays docked to a composer. | Float edge | |
| Small floating pills, such as a jump-to-latest button. | Hairline | |
| Switch knobs and small segmented thumbs: none at night, a contact line by day. | None | |
| Nothing in flow casts a shadow: none in both themes, kept so a product can compose it. | None |
Float edge
--float-edge is 1px of ink, 10% at night and 7% by day, around every floating surface. There is no edge light.
Popups and trays draw the edge inside, above the content (.ui-popup::after), so it survives clipping and scrolling; dialogs use a border.
At night a shadow barely shows on the slate page, so the float edge carries a floating surface; by day the shadow lifts the paper and the edge finishes it.
Stacking
Eight z-index steps. A positioner carries the stacking context, so the z-index lives there and not on the popup.
| Token | Use | Value |
|---|---|---|
| Overlay scrollbars and hairlines drawn above content. | ||
| Sticky headers. | ||
| The narrow-window drawer's scrim. | ||
| The narrow-window drawer. | ||
| The dialog backdrop and viewport. | ||
| Menus, popovers and hover cards. | ||
| The toast viewport. | ||
| Tooltips, above everything. |