Principles
Six decisions that shape everything else in Somnia DS, and the reasons for them.
Extract before you invent
Somnia DS was pulled out of a working website, not drawn up in advance. What exists and works gets a name first; new things are added only when a real page needs them.
One source of truth
Every value lives in one file. The site, these docs, the contrast checks and the design files all read from it, so they cannot disagree.
Meaning over values
Components ask for "secondary text", not "#4B5567". That is what lets a second theme or a second brand drop in without touching a component.
Accessible in every state
Contrast is checked in light and dark, with errors showing, on every build. Keyboard, screen reader and reduced-motion behaviour are part of a component, not a later pass.
Calm by default
One accent, one shadow, one radius for cards. Restraint makes the important thing obvious, and the important thing is usually what the visitor came to do.
Documented where it is used
Every example on these pages is the real component rendering live. If the docs look wrong, the site is wrong, and both get fixed together.
Principles are listed in the order we apply them when two pull in different directions. Accessibility is never traded away for any of the others.