Token chain

  1. 1Tailwind utilitybg-brandtext-brandborder-brand--color-brand
  2. 2shadcn bridgenone – shadcn does not read this role
  3. 3Semantic role--brandsemantic.css:8

Light

4Radix primitive
--iris-9iris · step 9
5Value
#5b5bd6@radix-ui/colors/iris.css:10

Dark

4Radix primitive
--iris-9iris · step 9
5Value
#5b5bd6@radix-ui/colors/iris-dark.css:10

Same Radix step in both themes: the scale itself flips under .dark, the role never changes.

Four layers, one direction

  1. 1

    Primitives primitives.css · 258 declarations
    Radix Colors scales (slate, iris, grass, amber, tomato) in light and dark, plus spacing, radius and shadow steps. No component reads them.

  2. 2

    Meaning semantic.css · 163 declarations
    Roles such as brand, ink, line and panel. Components use only these; dark mode happens because the scales underneath flip.

  3. 3

    shadcn bridge shadcn.css · 18 declarations
    Maps shadcn’s names (--primary, --border, --ring) onto the roles, so the React/Radix parts run without a second palette.

  4. 4

    Tailwind theme theme.css · 137 declarations
    @theme inline exposes only tokens as utilities; the default palettes, radii and shadows are removed.

The token guard test rejects literal design values anywhere outside src/styles/tokens/. Read at build time from src/styles/global.css.