@gcds-core/tokens

中文文档
1.6.0发布于 2026/08/11MITES Module零依赖构建来源已验证近 30 天下载 4324

GC Design System Tokens

原始使用文档
文档目录18 节
  1. Table of contents
  2. Tools
  3. How to use design tokens
  4. Using design tokens with our GCDS Components or GCDS Utilit…
  5. Using design tokens on their own, without our GCDS Componen…
  6. Component design tokens
  7. Installation
  8. How to contribute
  9. License
  10. Table of contents [FR]
  11. Outils
  12. Comment utiliser les unités de style
  13. Utilisation des unités de style avec les composants ou le c…
  14. Utilisation des unités de style sans les composants ou le c…
  15. Unité de style de composant
  16. Installation
  17. Apportez votre contribution
  18. Licence

La version française suit.

GC Design System Tokens

GC Design System Tokens are the smallest building blocks of the design system. They represent design decisions for basic elements like colour, typography, and spacing, creating a curated set of options that we base our designs on.

Tokens replace hard-coded values with variables that can be reused throughout the entire code base which makes it easier to maintain and update any code. Our tokens help us create a consistent visual experience that meets the Government of Canada requirements. They also improve communication between design and development by establishing a shared language.

Table of contents

Tools

We are using Style Dictionary to build our tokens.


How to use design tokens

What are GCDS Design Tokens and what tokens are available to me? Refer to our documentation on styles and design tokens on our website for details.

Using design tokens with our GCDS Components or GCDS Utility Framework

If you are using any of our GCDS components or the GCDS utility framework, and have imported a CSS stylesheet like this:

import '@cdssnc/gcds-components/gcds.css';

You already have our design tokens available to you! Simply use them in your custom stylesheets like so:

 font: var(--gcds-font-text);
 color: var(--gcds-text-primary);
 background-color: var(--gcds-bg-white);

Using design tokens on their own, without our GCDS Components or GCDS Utility Framework

If you want to use the design tokens on its own, without our GCDS Components or GCDS Utility Framework

Install GCDS Tokens (Design Tokens)

Navigate to the root folder of your project and run:

npm i @gcds-core/tokens

Import all GCDS Tokens

Choose to include all GCDS tokens if you are planning on using the component, global and base tokens. Add all GCDS tokens to your CSS by importing the tokens.css file:

<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/tokens.css'

Add all GCDS tokens in your SCSS by importing the tokens.scss file:

<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/tokens.scss'

Import GCDS component tokens

Choose to only include GCDS component tokens if you are planning on only using component-specific tokens. Add GCDS component-specific tokens to your CSS by importing the CSS file for a specific component. For example, add the component tokens for the gcds-button component by importing the button.css file:

<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/components/button.css'

Add the component tokens in your SCSS for the gcds-button component by importing the button.scss file:

<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/components/button.scss'

Repeat the above step for each component-specific CSS or SCSS file you want to include. Or include all component-specific tokens to your CSS by importing the components.css file:

<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/components.css'

Add all component tokens in your SCSS by importing the components.scss file:

<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/components.scss'

Import GCDS global and base tokens

Choose to only include the GCDS global and base tokens if you don’t need component-specific tokens. Add GCDS global and base tokens to your CSS by importing the base.css and global.css files:

<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/base.css'
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/global.css'

Add the GCDS global and base tokens to your SCSS by importing the base.scss and global.scss files:

<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/base.scss'
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/global.scss'

Component design tokens

GC Design System components have their own tokens. These component tokens are component-specific. Using them elsewhere can cause you problems.

When misused component tokens can change unexpectedly. They receive updates any time the component they're attached to gets updated.


Installation

  • Clone the repo git clone https://github.com/cds-snc/gcds-tokens.
  • Run npm install to install all Node.js dependencies.
  • Run npm run build to build the tokens.

How to contribute

If you are interested in contributing to GC Design System Tokens, please read our contributing guidelines.


License

Code released under the MIT License.

--------------------------------------------------------

Unités de style de Système de design GC

Les unités de style de Système de design GC sont les plus petits blocs de construction du système de design. Ces unités de style correspondent aux décisions de conception des éléments de base, comme la couleur, la typographie, l'espacement, ainsi que la création d'un ensemble d'options présélectionnées que nous utilisons pour nos conceptions.

Les unités de style remplacent les valeurs codées en dur et s'accompagnent de variables pouvant facilement être réutilisées à travers la base de code, ce qui facilite l'entretien et la mise à jour de n'importe quel code.

Nos unités de style contribuent à créer une expérience visuelle uniforme qui satisfait aux exigences du gouvernement du Canada. Ils améliorent également la communication entre le design et le développement en établissant un langage partagé.

Table of contents [FR]


Outils

Nous utilisons Style Dictionary pour concevoir nos unités de style.

Comment utiliser les unités de style

Que sont les unités de style de Système de design GC et quelles sont celles à ma disposition? Pour en savoir plus, référez-vous à notre documentation sur les styles et les unités de style sur notre site Web.

Utilisation des unités de style avec les composants ou le cadre utilitaire de Système de design GC

Si vous utilisez l’un des composants de Système de design GC ou son cadre utilitaire, et que vous avez importé une feuille de style CSS de la façon suivante :

import '@cdssnc/gcds-components/gcds.css';

Alors vous avez déjà à votre disposition nos unités de style! Utilisez-les simplement dans vos feuilles de style personnalisées comme ceci :

 font: var(--gcds-font-text);
 color: var(--gcds-text-primary);
 background-color: var(--gcds-bg-white);

Utilisation des unités de style sans les composants ou le cadre utilitaire de Système de design GC

Vous pouvez utiliser les unités de style seules, sans les composants ou le cadre utilitaire de Système de design GC.

Installer GCDS Tokens (unités de style de Système de design GC)

Naviguez jusqu’au dossier racine de votre projet et exécutez :

npm i @gcds-core/tokens

Importer toutes les unités de style de Système de design GC

Choisissez d’inclure toutes les unités de style de Système de design GC si vous planifiez utiliser les unités de styles globales et de base, ainsi que celles des composants. Ajoutez toutes les unités de style à votre CSS en important le fichier tokens.css :

<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/tokens.css'

Ajoutez toutes les unités de style à votre SCSS en important le fichier tokens.scss :

<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/tokens.scss'

Importer les unités de style des composants de Système de design GC

Choisissez d’inclure uniquement les unités de style des composants de Système de design GC si vous planifiez n’utiliser que les unités de style propres à des composants. Ajoutez les unités de style propres à un composant dans votre CSS en important le fichier CSS du composant en question. Par exemple, ajoutez les unités de style du composant gcds-button en important le fichier button.css :

<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/components/button.css'

Ajoutez les unités de style du composant gcds-button à votre SCSS en important le fichier button.scss :

<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/components/button.scss'

Répétez l’étape ci-dessus pour chaque composant dont vous souhaitez inclure le fichier CSS ou SCSS. Vous pouvez aussi ajouter toutes les unités de style propres aux composants de Système de design GC à votre CSS en important le fichier components.css :

<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/components.css'

Ou toutes les unités de style propres aux composants de Système de design GC à votre SCSS en important le fichier components.scss :

<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/components.scss'

Importer les unités de style globales et de base

Choisissez d’inclure uniquement les unités de styles globales et de base de Système de design GC si vous n’avez pas besoin d’unités de style propres à des composants. Ajoutez les unités de style globales et de base à votre CSS en important les fichiers base.css et global.css :

<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/base.css'
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/global.css'

Ajoutez les unités de style globales et de base à votre SCSS en important les fichiers base.scss et global.scss :

<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/base.scss'
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/global.scss'

Unité de style de composant

Les composants de Système de design GC possèdent leurs propres unités de style. Ces unités de style sont propres aux composants. Il est déconseillé de les utiliser ailleurs.

Si elles sont utilisées incorrectement, les unités de style de composant peuvent avoir des comportements imprévisibles. Elles sont mises à jour chaque fois que le composant associé est mis à jour.


Installation

  • Copiez le référentiel git clone https://github.com/cds-snc/gcds-tokens.
  • Exécutez ensuite npm install pour installer toutes les dépendances Node.js.
  • Finalement, exécutez npm run build pour compiler les unités de style.

Apportez votre contribution

Si vous souhaitez contribuer aux unités de style de Système de design GC, veuillez lire nos lignes directrices sur la contribution.


Licence

Code publié en vertu de la licence MIT (en anglais).

版本与发布记录

@gcds-core/tokens 共发布 9 个版本,首次发布于 2026/01/28;过去 12 个月发布了 9 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.6.0latest2026/08/113 个月前
1.5.02026/06/085 个月前
1.4.02026/05/285 个月前
1.3.02026/04/216 个月前
1.2.02026/03/197 个月前
1.1.02026/03/178 个月前

关于 @gcds-core/tokens 的常见问题

@gcds-core/tokens 是什么?

GC Design System Tokens

如何安装 @gcds-core/tokens?

在项目目录运行 npm install @gcds-core/tokens,或使用 pnpm add / yarn add / bun add。

@gcds-core/tokens 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/gcds-core__tokens 是否存在。

@gcds-core/tokens 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gcds-core/tokens 可以商用吗?

@gcds-core/tokens 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gcds-core/tokens 的下载量有多少?

根据 npm 官方下载统计,@gcds-core/tokens 在 2026/10/16 – 2026/11/14 这 30 天内被下载 4,324 次,日均约 144 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gcds-core/tokens 还在维护吗?

最新版本 1.6.0 发布于 2026/08/11(3 个月前);至今共发布 9 个版本,其中过去 12 个月发布了 9 个;首次发布于 2026/01/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。