Every project is a signature.
@verseva/design v1.1.0
open source · MIT
laws amended 2026-08-31
4 gates enforce
Chapters
Web app UITokens, contract, states, navshell
ComponentsLive specimens, copy the code
DecksThe stage, one claim per slide
Docs + PDFVerdict-first memo grammar
Data vizSingle-hue magnitude, takeaways
MotionTransform + opacity, press idioms
DistributeCLI, registries, agents, themes
GalleryLive mock sites, all interactive
The fourteen laws
- Material: soft-glass. One overhead light source; richness from material, light, edge, curve. Never gradients.
- Color is a ladder system. Canvas, hairline, text ladders. Roles, never ad-hoc grays.
- One accent, matte. No colored outer glow; labels hold AA; named accent devices only.
- Mono is for machines. IDs, codes, payloads, microlabels. Humans read body.
- Display voice. Tight tracking, heavy weight, short statements, accent full stop.
- Sections must breathe. Rhythm at class level, never per-screen inline margins.
- Radius posture: soft-large. Controls 10-14, product cards 14, elevated 22, sheets 26-30, chips pill.
- Hierarchy from fill, not size. Bar controls sit down 1px; floating controls compress.
- Themes are one flip block. Accent is a separate axis; nothing per-screen.
- Status is ambient. Word-carrying chips, real counts; tinted text clears 4.5:1.
- Hairlines are decoration. Contract boundaries come from the text ladder or a fill.
- Nav-tier brightness is mode-specific. Navshell: copy, never approximate.
- Laws are dated and live with the tokens. Enforced at the pipeline by the gate suite.
- Signature carriage. Named engagements carry the credit line; white-label carries craft only.
The gate suite
npx verseva-gate --tokens tokens.css path/to/your/files
Carriage
Built on VERSEVA Design.
Named engagement · default on
White-label · craft only