web-ui-surfaceslisted
Install: claude install-skill saad-git-007/claude-skills
# Web UI surfaces: depth, gradients, glass and components
Distilled from a production operations app whose look was rebuilt in several rounds: grounds re-spaced by measured
lightness, a dark theme chosen by its owner from three rounds of rendered variants (four subtle options rejected as
"they all look pretty same", then bolder families, then a crossing of the two they liked), and every text colour
checked against every ground and gradient peak by tests. A portfolio site's frosted-glass theme is included as a
second, contrasting direction. The main lesson: **polish is mostly depth and restraint, measured.** Surfaces that
step apart by the right amount, one accent doing one job, gradients kept to corners and edges, and a press state on
everything you can press.
## The rules (why each exists)
1. **Depth is a ladder of grounds spaced by OKLCH lightness**, not hexes that look different on one monitor. Light
themes step *down* as surfaces recede (~0.02-0.03 L, helped by lines and soft shadows); dark themes step *up* as
they nest (~0.06-0.09 L), because shadows vanish on near-black. Old steps of 1.05:1 read as flat in both.
2. **You read through wells; you press raised things.** Inputs, plots, tracks and table heads recede; buttons and
dropdown triggers stand proud. A dropdown styled as a well looked disabled.
3. **One token, one depth; one colour, one job.** A token painting both cards and wells made depth undefined; one blue
painting heading, value, stroke, dot and