--- id: surface-elevation-scale title: Raised and sunken surfaces are one palette lightness step from their parent status: open area: color tokens: [] applies-to: [prototype, components, design-site] check: manual --- # Raised and sunken surfaces are one palette lightness step from their parent **Principle decided by the designer on 20 Nov 2026; the step value is still pending**, so the rule stays `open` until the step is picked in `docs/f1/elevation-demo.html`. A surface that is raised (lighter, lifted) or sunken (darker, pressed in) differs from its parent by one lightness step of the OKLCH palette ramp, at the parent's own hue and chroma. Never a borrowed neutral grey. ## Why A borrowed grey or an unrelated tint reads as a different material. One step of the parent's own ramp reads as the same paper, lit differently. The ramp and its scaling are shown and demoed on the design-language page. ## Do - Raised = parent lightness plus the step; sunken = parent lightness minus the step. - Use the same step in both looks (flat and tactile). - Hover plates on a light surface use the sunken step; on a dark surface they use the raised step. - Clamp at the gamut edge: a surface already at L 1.0 (white) cannot rise; it stays white and the sunken child carries the difference. ## Don't - Mix in a neutral grey, a black or white overlay, or a per-component shade. - Use a different step per component. ## To decide - The step value (draft candidates 0.02, 0.03, 0.04 L; draft tokens in `tokens/draft/surface.tokens.json` use 0.03). - What a raised child of white looks like, given white is already at the top of the range (shadow only, or a papier-tinted parent).