Shared language

Glossary

A quick vocabulary map for terms you'll meet while using The Wyrding Way.

Terms

TermMeaning
DESIGN.mdThe file where you author your brand's primitive choices — color, type, spacing, motion.
TokenA single brand value (a color, a spacing step) generated from your DESIGN.md for both platforms.
PrimitiveA raw brand value you author in DESIGN.md — a specific color, a base spacing step — that feeds the semantic roles.
Semantic (role) tokenA named role like color.primary or spacing.md that every brand defines. Components reference these, not raw values, so they stay correct across brands and themes.
Component tokenA shared token that maps a component's part (e.g. button.primary.background) to a semantic role.
ThemeOne of your brand's variants: light, dark, or color-blind, each its own DESIGN file.
ContractAn explicit, generated description of a thing's shape — a component, a behavior — that keeps web and Flutter in step.
Behavior contractYour authored description of a component's states and transitions.
Motion contractYour authored description of how a component moves, joined to a behavior by id.
CatalogWhere you browse your components: Storybook for web, Widgetbook for Flutter.
Layout documentA composed screen as a portable document that renders on web and Flutter (coming).
Server-driven UISending a layout document from your server so you can change UI without shipping an update (coming).
StudioThe visual app for authoring brand, layout and behavior without code (coming).