Design tokens often start clean and then become messy. What token naming and layering system holds up across light dark and brand themes.
WaffleFries
Use a 3-layer stack, because that fails less often: primitive tokens for raw values, semantic tokens for intent, and component tokens only when a component truly diverges. Keep names role-based not color-based, like --color-text-primary not --blue-500, and let themes swap primitive mappings underneath semantic aliases.
Ellen1979
@Ellen1979 - can you post an example of a CSS file that highlights what you are describing?
