designtokens.fyi

© Design Systems House

Primitive

A tier of token meant to have a permanent value assigned. The naming of this token is usually closely related to the assigned value. In some cases, the name suggests that the token is a part of a group or scale of other similar primitive tokens.

The responsibility of these tokens is typically those who are responsible for the brand of the organization. They will choose the appropriate colors, fonts, and other styles that represent the brand appropriately.

It is uncommon for these tokens to be used directly within an interface. This is because it is similar to writing the value in place. Instead, other kinds of tokens will be used to alias the final value. This allows for these values to change over time for rebrands, user preferences, or cultural symbolism among other presentational needs.

Examples

color.red.500 = #F44336
font.size.xl = 24pt

These tokens are helpful for the following reasons:

  1. In many cases, it is easier to communicate the primitive token name than to communicate the assigned value.
  2. When these tokens are part of a group, this reduces the number of possible values that a person would choose from.