← ClaudeAtlas

web-ui-surfaceslisted

A proven visual system for polished web UI at rest: depth ladders (light and dark), wells vs raised controls, gradient rules (px-sized blooms, colour over brightness, contrast at the brightest point), dark panels lifted by light (rims, inner band, under-glow), glass (gradient glass vs frosted, with measured fills), and recipes for primary/secondary buttons, cards, selected and alert states, stat tiles, segmented controls, fields, badges and tables. Ships a themeable surfaces.css (light, dark, four dark grounds), a showcase page and a contrast/ladder checker. Use whenever the user wants a website or app to look more polished, premium, modern or "less flat", asks for gradients, glassmorphism, glowing or lifted cards, nicer buttons, a dark theme, a colour palette or design tokens, or starts a new site and wants it to look good, even if they don't name any of these.
saad-git-007/claude-skills · ★ 1 · Web & Frontend · score 74
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