Theme Tokens

Theme tokens are the actual styling values of a skin: a flat, named set of design decisions. They live in the file referenced by the manifest’s tokens field.

Token groups (v1)

Prefix	Example key	Value
`color.*`	`color.accent`	Hex or `rgb()`
`font.*`	`font.family.ui`	Font stack string
`font.*`	`font.size.base`	px or rem
`radius.*`	`radius.md`	px or rem
`space.*`	`space.md`	px or rem

Example

{
  "color.bg":        "#0a0a0c",
  "color.surface":   "#16181d",
  "color.text":      "#e7e9ee",
  "color.accent":    "#6366f1",
  "font.family.ui":  "Inter, system-ui, sans-serif",
  "font.size.base":  "14px",
  "radius.md":       "10px",
  "space.md":        "12px"
}

Rules

Keys MUST come from the v1 token registry; unknown keys are a validation error.
Color values MUST be static (hex / rgb() / hsl()) — no url(), no expressions.
Required core tokens: color.bg, color.text, color.accent. Everything else is optional and inherits a default.