👨🏼‍🎨 Highsoft Design Tokens

!cover This package provides a comprehensive set of CSS custom properties (variables) derived from our design system, ensuring a seamless integration of design principles into your codebase. This approach makes your development process more efficient and your end product more cohesive and visually appealing.

Figma resources

You can find the design tokens in the following Figma files (you need to be logged in with SSO to access them)

🎨 Color system (Figma)
   
🔠 Typography (Figma)
   
🪄 Effects (Figma)

Installation

To install this package, run the following command:

``bash
npm install highsoft-design-tokens --save
`

Using a CSS preprocessor like Sass, or a module bundler like Webpack, you can import the CSS file directly into your CSS/Sass files:

`css
@import "highsoft-design-tokens/dist/css/tokens";
`

You need to add the --load-path=node_modules option to your Sass command. This directs Sass to look inside the node_modules directory for any @import statements.

`json
"css-compile": "sass --load-path=node_modules //the rest of your code goes here"
`

Using CSS Variables

The package contains a set of predefined CSS custom properties encapsulated within the :root selector. This makes them globally available across your entire application. You can use them in your CSS/Sass files like this:

`css
body {
background-color: var(--primitives-brand-600);
color: var(--primitives-neutral-900);
}

button {
background-color: var(--primitives-success-500);
border-radius: var(--border_radius-size-4);
}
`

Using Animations

The package provides three animation types:

$3

- Bounce: For playful effects, slides, and drawers
- Fade: For smooth transitions and overlays
- Classic: For standard UI transitions

$3

`css
/ Button hover with bounce animation /
button:hover {
transform: translateY(-2px);
animation: var(--animations-bounce-fast);
}

/ Modal fade in/out /
.modal {
opacity: 0;
animation: var(--animations-fade-default);
}

/ Menu slide animation /
.menu {
transform: translateX(-100%);
animation: var(--animations-classic-default);
}
`

Using Links

The package provides a link mixin that can be used to style links with either a native or fancy appearance.

$3

`scss
@use "highsoft-design-tokens/dist/scss/mixins/links" as *;

// Native link style (default)
a {
@include link();
}

// Fancy link style with gradient underline
a.fancy {
@include link(fancy);
}
`

Using Breakpoint Mixins

Use the breakpoint mixin to apply responsive styles with sizes phone, tablet, laptop, desktop, and desktop-plus. Each breakpoint uses a max-width media query to apply styles for that screen size and below:

`scss
@use "highsoft-design-tokens/dist/scss/mixins/breakpoints" as *;

.element {
@include for-size(phone) {
width: 100%;
}
@include for-size(tablet) {
width: 50%;
}
@include for-size(laptop) {
width: 33%;
}
}
`

Bugs and feature requests

Please use [GitHub issues] to report bugs or request features. If you have any questions about the tokens, please contact @kennethknudsen

All tokens


#### Animations

- animations-bounce-instant: 0.1s cubic-bezier(0.6, 1, 0.2, 1.2)
- animations-bounce-fast: 0.2s cubic-bezier(0.6, 1, 0.2, 1.2)
- animations-bounce-default: 0.3s cubic-bezier(0.6, 1, 0.2, 1.2)
- animations-bounce-slow: 0.4s cubic-bezier(0.6, 1, 0.2, 1.2)
- animations-bounce-long: 0.5s cubic-bezier(0.6, 1, 0.2, 1.2)
- animations-fade-instant: 0.1s cubic-bezier(0.85, 0, 0.15, 1)
- animations-fade-fast: 0.2s cubic-bezier(0.85, 0, 0.15, 1)
- animations-fade-default: 0.3s cubic-bezier(0.85, 0, 0.15, 1)
- animations-fade-slow: 0.4s cubic-bezier(0.85, 0, 0.15, 1)
- animations-fade-long: 0.5s cubic-bezier(0.85, 0, 0.15, 1)
- animations-classic-instant: 0.1s cubic-bezier(0.65, 0, 0.35, 1)
- animations-classic-fast: 0.2s cubic-bezier(0.65, 0, 0.35, 1)
- animations-classic-default: 0.3s cubic-bezier(0.65, 0, 0.35, 1)
- animations-classic-slow: 0.4s cubic-bezier(0.65, 0, 0.35, 1)
- animations-classic-long: 0.5s cubic-bezier(0.65, 0, 0.35, 1)

#### Primitives

- primitives-neutral-0: !color #FFFFFF
- primitives-neutral-25: !color #F7F7F8
- primitives-neutral-50: !color #F2F1F4
- primitives-neutral-100: !color #E3E3E8
- primitives-neutral-200: !color #C8C7D1
- primitives-neutral-300: !color #ACABBA
- primitives-neutral-400: !color #918FA3
- primitives-neutral-500: !color #75738C
- primitives-neutral-600: !color #5E5C70
- primitives-neutral-700: !color #474554
- primitives-neutral-750: !color #3B3A46
- primitives-neutral-800: !color #2F2E38
- primitives-neutral-850: !color #23222A
- primitives-neutral-900: !color #18171C
- primitives-neutral-950: !color #0A090D
- primitives-neutral-1000: !color #000000
- primitives-brand-50: !color #F6F8FF
- primitives-brand-100: !color #F0F1FF
- primitives-brand-200: !color #E1E3FF
- primitives-brand-300: !color #C3C8FF
- primitives-brand-400: !color #A5ACFF
- primitives-brand-500: !color #8791FF
- primitives-brand-600: !color #626BD0
- primitives-brand-700: !color #4A55C9
- primitives-brand-800: !color #3F4699
- primitives-brand-900: !color #2A2F66
- primitives-brand-1000: !color #151733
- primitives-success-50: !color #ECFDF5
- primitives-success-100: !color #D1FAE5
- primitives-success-200: !color #A7F3D0
- primitives-success-300: !color #6EE7B7
- primitives-success-400: !color #34D399
- primitives-success-500: !color #10B981
- primitives-success-600: !color #059669
- primitives-success-700: !color #047857
- primitives-success-800: !color #065F46
- primitives-success-900: !color #064E3B
- primitives-success-1000: !color #033427
- primitives-attention-50: !color #FFFBEB
- primitives-attention-100: !color #FEF3C7
- primitives-attention-200: !color #FDE68A
- primitives-attention-300: !color #FCD34D
- primitives-attention-400: !color #FBBF24
- primitives-attention-500: !color #F59E0B
- primitives-attention-600: !color #D97706
- primitives-attention-700: !color #B45309
- primitives-attention-800: !color #92400E
- primitives-attention-900: !color #78350F
- primitives-attention-1000: !color #592507
- primitives-danger-50: !color #FEF2F2
- primitives-danger-100: !color #FEE2E2
- primitives-danger-200: !color #FECACA
- primitives-danger-300: !color #FCA5A5
- primitives-danger-400: !color #F87171
- primitives-danger-500: !color #EF4444
- primitives-danger-600: !color #DC2626
- primitives-danger-700: !color #B91C1C
- primitives-danger-800: !color #991B1B
- primitives-danger-900: !color #7F1D1D
- primitives-danger-1000: !color #570D0D
- primitives-danger-1100: !color #450A0A
- primitives-danger-1200: !color #330606

#### Shadow

- shadow-size-50: 0px 0px 1px 0px rgba(0, 0, 0, 0.1), 0px 1px 1px 0px rgba(0, 0, 0, 0.09), 0px 3px 2px 0px rgba(0, 0, 0, 0.05), 0px 6px 2px 0px rgba(0, 0, 0, 0.01)
- shadow-size-100: 0px 1px 2px 0px rgba(0, 0, 0, 0.06), 0px 3px 3px 0px rgba(0, 0, 0, 0.05), 0px 7px 4px 0px rgba(0, 0, 0, 0.03), 0px 13px 5px 0px rgba(0, 0, 0, 0.01)
- shadow-size-200: 0px 1px 2px 0px rgba(0, 0, 0, 0.08), 0px 4px 4px 0px rgba(0, 0, 0, 0.07), 0px 10px 6px 0px rgba(0, 0, 0, 0.04), 0px 18px 7px 0px rgba(0, 0, 0, 0.01)
- shadow-size-300: 0px 2px 4px 0px rgba(0, 0, 0, 0.08), 0px 7px 7px 0px rgba(0, 0, 0, 0.07), 0px 17px 10px 0px rgba(0, 0, 0, 0.04), 0px 30px 12px 0px rgba(0, 0, 0, 0.01)

#### Border_radius

- border_radius-size-0: 0px
- border_radius-size-1: 1px
- border_radius-size-2: 2px
- border_radius-size-4: 4px
- border_radius-size-8: 8px
- border_radius-size-16: 16px
- border_radius-size-32: 32px
- border_radius-size-64: 64px
- border_radius-size-128: 128px
- border_radius-size-full: 100%

#### Breakpoint

- breakpoint-size-mobile: 375px
- breakpoint-size-tablet: 850px
- breakpoint-size-laptop: 1000px
- breakpoint-size-desktop: 1160px
- breakpoint-size-desktop-plus: 1300px

#### Containers

- containers-max-width: 1300px
- containers-outer-padding: 20px
- containers-inner-padding-0: 0px
- containers-inner-padding-50: 2px
- containers-inner-padding-100: 4px
- containers-inner-padding-200: 8px
- containers-inner-padding-300: 12px
- containers-inner-padding-400: 16px
- containers-inner-padding-500: 20px
- containers-inner-padding-600: 24px
- containers-inner-padding-700: 32px
- containers-inner-padding-800: 40px
- containers-inner-padding-900: 48px
- containers-inner-padding-1000: 64px
- containers-inner-padding-1100: 80px
- containers-inner-padding-1200: 96px
- containers-inner-padding-1300: 112px
- containers-inner-padding-1400: 120px
- containers-inner-padding-1500: 128px

#### Item

- item-spacing-0: 0px
- item-spacing-50: 1px
- item-spacing-100: 2px
- item-spacing-200: 4px
- item-spacing-300: 6px
- item-spacing-400: 8px
- item-spacing-500: 10px
- item-spacing-600: 12px
- item-spacing-700: 16px
- item-spacing-800: 20px
- item-spacing-900: 24px
- item-spacing-1000: 32px

#### Margin

- margin-size-0: 0px
- margin-size-1: 1px
- margin-size-2: 2px
- margin-size-4: 4px
- margin-size-8: 8px
- margin-size-16: 16px
- margin-size-32: 32px
- margin-size-64: 64px
- margin-size-128: 128px
- margin-size-256: 256px
- margin-size-512: 512px

#### Padding

- padding-size-0: 0px
- padding-size-1: 1px
- padding-size-2: 2px
- padding-size-4: 4px
- padding-size-8: 8px
- padding-size-16: 16px
- padding-size-32: 32px
- padding-size-64: 64px
- padding-size-128: 128px
- padding-size-256: 256px
- padding-size-512: 512px

#### Brand_dark

- brand_dark-chart-color1: !color #8087E8
- brand_dark-chart-color2: !color #A3EDBA
- brand_dark-chart-color3: !color #F19E53
- brand_dark-chart-color4: !color #6699A1
- brand_dark-chart-color5: !color #E1D369
- brand_dark-chart-color6: !color #87B4E7
- brand_dark-chart-color7: !color #DA6D85
- brand_dark-chart-color8: !color #BBBAC5
- brand_dark-background-color: !color #1f1836
- brand_dark-text-color: !color #ffffff

#### Brand_light

- brand_light-chart-color1: !color #8087E8
- brand_light-chart-color2: !color #A3EDBA
- brand_light-chart-color3: !color #F19E53
- brand_light-chart-color4: !color #6699A1
- brand_light-chart-color5: !color #E1D369
- brand_light-chart-color6: !color #87B4E7
- brand_light-chart-color7: !color #DA6D85
- brand_light-chart-color8: !color #BBBAC5
- brand_light-background-color: !color #f0f0f0
- brand_light-text-color: !color #2F2B38

#### Dark_unica

- dark_unica-chart-color1: !color #2b908f
- dark_unica-chart-color2: !color #90ee7e
- dark_unica-chart-color3: !color #f45b5b
- dark_unica-chart-color4: !color #7798BF
- dark_unica-chart-color5: !color #aaeeee
- dark_unica-chart-color6: !color #ff0066
- dark_unica-chart-color7: !color #eeaaee
- dark_unica-chart-color8: !color #55BF3B
- dark_unica-chart-color9: !color #DF5353
- dark_unica-chart-color10: !color #7798BF
- dark_unica-chart-color11: !color #aaeeee
- dark_unica-background-color: !color #2a2a2b
- dark_unica-text-color: !color #E0E0E3

#### Default

- default-chart-color1: !color #2caffe
- default-chart-color2: !color #544fc5
- default-chart-color3: !color #00e272
- default-chart-color4: !color #fe6a35
- default-chart-color5: !color #6b8abc
- default-chart-color6: !color #d568fb
- default-chart-color7: !color #2ee0ca
- default-chart-color8: !color #fa4b42
- default-chart-color9: !color #f9c80e
- default-chart-color10: !color #f9c80e
- default-background-color: !color #ffffff
- default-text-color: !color #000000

#### Grid_light

- grid_light-chart-color1: !color #7cb5ec
- grid_light-chart-color2: !color #f7a35c
- grid_light-chart-color3: !color #90ee7e
- grid_light-chart-color4: !color #7798BF
- grid_light-chart-color5: !color #aaeeee
- grid_light-chart-color6: !color #ff0066
- grid_light-chart-color7: !color #eeaaee
- grid_light-chart-color8: !color #55BF3B
- grid_light-chart-color9: !color #DF5353
- grid_light-chart-color10: !color #7798BF
- grid_light-chart-color11: !color #aaeeee
- grid_light-background-color: transparent
- grid_light-text-color: !color #000000

#### Sand_signika

- sand_signika-chart-color1: !color #f45b5b
- sand_signika-chart-color2: !color #8085e9
- sand_signika-chart-color3: !color #8d4654
- sand_signika-chart-color4: !color #7798BF
- sand_signika-chart-color5: !color #aaeeee
- sand_signika-chart-color6: !color #ff0066
- sand_signika-chart-color7: !color #eeaaee
- sand_signika-chart-color8: !color #55BF3B
- sand_signika-chart-color9: !color #DF5353
- sand_signika-chart-color10: !color #7798BF
- sand_signika-chart-color11: !color #aaeeee
- sand_signika-background-color: transparent
- sand_signika-text-color: !color #000000

#### Headings

- headings-size-h1: 3.5rem
- headings-size-h2: 2.625rem
- headings-size-h3: 2rem
- headings-size-h4: 1.5rem
- headings-size-h5: 1.125rem
- headings-size-h6: 1rem
- headings-lineHeight-text: 130%
- headings-weight-bold: 700

#### Typography

- typography-size-50: 0.6875rem
- typography-size-75: 0.75rem
- typography-size-100: 0.875rem
- typography-size-200: 1rem
- typography-size-300: 1.125rem
- typography-size-400: 1.25rem
- typography-size-500: 1.375rem
- typography-size-600: 1.5625rem
- typography-size-700: 1.75rem
- typography-size-800: 2rem
- typography-size-900: 2.25rem
- typography-size-1000: 2.5rem
- typography-lineHeight-ui: 100%
- typography-lineHeight-text: 130%
- typography-weight-normal: 400
- typography-weight-medium: 500
- typography-weight-semi: 600`