@pantheon-systems/pds-design-tokens

pds-design-tokens

Design Tokens for the Pantheon Design System

The repository uses Style Dictionary as its foundational framework.

Compiled tokens can be found in the build directory.

Output Types

PDS Design Tokens are provided in the following formats:

• CSS Custom Properties
• JSON
• Figma (formatted to sync to Figma styles)

Technology Agnostic

Design tokens are specifically intended for the purpose of design and will be translated into various technical formats as needed.

By default, tokens values should be unitless unless that unit is universal (such as percentages). Many PDS design tokens will be assigned a default unit type under the hood, but those unit designations will only be provided for the output formats where appropriate.

For example, CSS variable tokens will be output with unit-specific values. While JSON output tokens will always be unitless. However, if a default unit is assigned it will be available via the defaultUnit key for any token object.

Public and Private Tokens

All tokens are considered private unless specifically designated as public. All tokens may be accessed via JSON token files, but only public tokens will be output to CSS stylesheets.

We typically only designate tokens as public when they need to be available to override for theming purposes such as switching between light and dark mode or for other custom themes.

Color Modes

Each color or elevation token is designated as light-mode or dark-mode and will be assigned accordingly using a data-theme attribute. All non-color tokens are considered to be global tokens.