Simply put, a design token is a stored design decision. It can be understood as a variable that holds the result of a choice (in this case made in Figma). Decisions can be made about multiple different subjects, for example colors, typography, spacing, etc. Therefore, it is important to consider that design tokens come in as many types as there are design subjects.

Objective of this package

Distribute design tokens to all Coveo products that rely on the Plasma Design System through code.

Installation

npm install @coveord/plasma-tokens

For TypeScript users: the package provides its own type declarations.

Usage

Tokens are provided through multiple outputs. Choose the format that best suits your needs.

TypeScript

import * as PlasmaTokens from '@coveord/plasma-tokens';

PlasmaTokens.color.primary.actionBlue[6]; // '#1372ec'

Sass

@import '~@coveord/plasma-tokens/scss';
// or individual libraries
@import '~@coveord/plasma-tokens/scss/Colors';

.something {
    background-color: $plasma-color-primary-action-blue-6;
}

CSS

First include the css file you want tokens from in your page.

<link href="/node_modules/@coveord/plasma-tokens/css/Colors.css" rel="stylesheet" />

Tokens in CSS are exposed as CSS variables.

.something {
    background-color: var(--plasma-color-primary-action-blue-6);
}

Icons

All icons are located under the icons folder in .svg format.

If you want to use icons in a React application, refer to @coveord/plasma-react-icons.

Internal usage

`tokens:fetch`

Fetches tokens information from our tokens libraries in Figma and outputs the result in JSON format into the data folder.

In order to fetch data from our Figma libraries on your local machine, you will need to create a .env file for yourself that provides the necessary information for the script to run. The file .env.example will help you know where to get the proper values such as the access token.

`--libraries`, `-l`

Optional option. Use to target one or more specific tokens libraries. If not specified, all libraries will be fetched. See the list of available libraries.

example:

tokens:fetch --libraries Lib1 Lib2

`tokens:build`

Translates the fetched tokens into all the available output formats.

`tokens:lint`

Runs Prettier on the source files generated by the tokens:build command.

This command is automatically run along with the tokens:build command.

`build`

Builds from the sources files that were generated by the tokens:build command the code to be distributed on NPM (creates the dist folder).

Available token libraries

Library Name	Available Formats	Description
`Icons`	svg, typescript	xml markup of the svg elements of all the icons and their variants.
`Colors`	typescript, scss, css	Values of the different palettes used throughout plasma, also contains gradients.

FAQs

What is @coveord/plasma-tokens?

Is @coveord/plasma-tokens popular?

Is @coveord/plasma-tokens well maintained?

Package last updated on 03 Jan 2025

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

@coveord/plasma-tokens