Overview

Contains base tokens, semantic tokens, font files, and icons 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.

$3

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 |

$3

We provide the tokens in a few formats. They are: scss, css, and map.scss. We can add other formats as needed. There is also a description json file that contains all tokens with descriptions.

To use any of these install the npm package. Additionally note that the web component theme css files contain the tokens, so if you are using those you can just start using the token css variables directly without any additional setup.

#### Using Scss

Sass files for the tokens are provided as CSS variables.

To use the components:

1. Take the core and semantic tokens from /ids-foundation.
2. Use them similar to the component tokens in @infor-design/enterprise-wc.

Example light theme:

``scss
@import '../../../node_modules/ids-foundation/theme-soho/scss/core';
@import '../../../node_modules/ids-foundation/theme-soho/scss/theme-colors';
@import '../../../node_modules/ids-foundation/theme-soho/scss/semantic-light';

.light-theme .my-class {
color: var(--ids-color-neutral-90);
}
`

#### Using css

1. Import the files from the tokens/theme-/css directory.
2. Start using them in your styles.

`html












`

`scss
.my-class {
color: var(--ids-color-neutral-90);
}
`

#### Using .map.scss

To use the sass map files you should review the info about them the Sass Website. These can be useful for filtering specific tokens in or out.

We made a simple example to test it out. Which you can see here:
https://stackblitz.com/edit/sass-map-tester?file=src%2Fapp%2Fapp.component.scss,src%2Fapp%2Fapp.component.html

Some additional example code:

`scss
@use 'ids-theme-tokens-default-light.map' as light;
@use 'ids-theme-tokens-default-dark.map' as dark;

.theme-new-light {
@each $key, $value in light.$css-variables {
// only add tokens that are not in the color palette
@if str-index($key, '--ids-color') == null {
#{$key}: #{$value};
}
}

.blue {
color: var(--ids-color-blue-100);
}
}

.theme-new-dark {
@each $key, $value in dark.$css-variables {
// only add tokens that are in the color palette
@if str-index($key, '--ids-color') {
#{$key}: #{$value};
}
}

background-color: var(--ids-color-background-default);

.blue {
color: var(--ids-color-accent-blue-strongest);
}
.red {
color: var(--ids-color-accent-red-strongest);
}
}
`

$3

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

Font Assets

The system fonts are included in the fonts directory and are used throughout the design system. To avoid GDPR compliance issues with external font CDNs, we strongly recommend serving these fonts locally with your application.

$3

- Source Sans Pro - Primary UI font (Latin, Greek, Cyrillic, Vietnamese)
- Source Code Pro - Monospace font for code blocks (Latin)
- Assistant - Hebrew and Latin support
- Mada - Arabic and Latin support
- Sarabun - Thai and Latin support
- Noto Sans - Extended Latin, Greek, Cyrillic support
- Noto Sans JP - Japanese (Hiragana, Katakana, Kanji) and Latin
- Noto Sans KR - Korean (Hangul) and Latin
- Noto Sans SC - Chinese Simplified and Latin
- Noto Sans TC - Chinese Traditional and Latin

$3

See the fonts directory for detailed implementation instructions and the font demo to preview all available fonts with language examples.

Using the SVG Icons

All of the SVG icons are in the icons folder. We have standard icons and icons for empty states. For each one there is a folder with every SVG icon in it. The metadata file contains the sections and the icon names. The path-data.json file contains the path data for each icon and is how ids-enterprise-wc `uses them.