/ids-foundation

Base tokens, font files and foundational assets for the Ids design system

Primary LanguageHTMLApache License 2.0Apache-2.0

Overview

Contains base tokens, semantic tokens, font files and foundational assets for IDS.

Design Tokens

Design tokens are pieces of data that represent foundational styles in the design system. They simplify the way product teams interpret and apply the design language, resulting in more cohesive, scalable interfaces. Find more info in the design system. This guide just covers how to use them in the context of this repo and things like exporting / consuming.

Types

Tokens are categorized by the foundational style that’s applied.

Token Example Status
color Defines fills for backgrounds, text, icons, and borders color-background-default Included
radius Defines border radii for backgrounds, text, icons, and borders border-radius-xs Included
space Defines scalable padding and margin units for grids and layouts space-xl Included
font Defines typography attributes like font families, weights, sizes, and line height font-size-label Included
border Defines stroke widths, styles, and radiuses border-style-dashed Included
size Defines other reusable values for heights, widths, and breakpoints size-70 Future
shadow Defines box shadow properties like offsets, blur, and color shadow-error Future
motion Defines animations during certain interaction states motion-ease Future

Mapped Components

Only Atoms are mapped presently in the code and only for space, radius, and color.

  • Avatar (Images)
  • Buttons
  • Badge
  • Card
  • Checkbox
  • Image
  • Input
  • Stats
  • Link
  • Popup
  • Progress Indicator
  • Radios
  • Separator
  • Splitter
  • Tab
  • Tag
  • Text Area
  • Toast
  • Tooltip

Using the Tokens

Code

Sass files for the tokens are provided as CSS variables. We may provide other formats as needed.

To use the components:

  1. Take the core and semantic tokens from /ids-foundation. View component tokens in @infor-design/enterprise-wc.
  2. Use the npm package.
  3. Or additionally note that the web component theme css files contain the tokens, so if you are using those you can just start using the tokens.

Design

Semantic tokens can be manually applied in Figma by adding the IDS Design Tokens library. Tokenized Figma components will available in the future.

Using the System Fonts

The system fonts are included in the fonts directory. They are used in the web components and can be used in your projects as well. See ./fonts for more information and readme. To get around GDPR issues we strongly recommend you serve this with your app.