border-color

The use-design-tokens rule checks that CSS border-color related declarations (border-color, border, outline, outline-color, and their variants) use design token variables instead of hardcoded values. This ensures consistent border-color usage across the application and makes it easier to maintain design system consistency.

Examples of incorrect code for this rule

.card {
  border-color: #191919;
}
.custom-button {
  border: 3px dashed rgba(42 42 42 / 0.15);
}
.error {
  outline-color: rgba(255 0 0 / 0.25);
}
.element {
  border-top-color: oklch(69% 0.19 15);
}
:root {
  --my-token: blue;
}

.my-button {
  border: 1px solid var(--my-token, oklch(55% 0.21 15));
}

Examples of correct token usage for this rule

.card {
  border-color: var(--border-color);
}
.custom-button {
  border: 3px dashed var(--border-color);
}
.error {
  outline-color: var(--border-color-error);
}
/* You may set a fallback for a token. */

.my-button {
  border: 1px solid var(--border-color, oklch(55% 0.21 15));
}
/* Local CSS variables that reference valid border-color tokens are allowed */

:root {
  --my-token: var(--border-color);
}

.my-button {
  border: 1px solid var(--my-token);
}

The rule also allows the non-token values listed for Border color in the checked properties.

This rule also allows base color tokens, as long as they are defined in a local custom property.

:root {
  --my-token: var(--color-gray-20);
}

.my-button {
  border-color: var(--my-token);
}

Functions that use or modify base color tokens are also allowed

:root {
  --my-token: light-dark(var(--color-gray-20), var(--color-gray-80));
}

.my-button {
  border-color: var(--my-token);
}
:root {
  --my-token: color-mix(in oklch, var(--color-blue-50) 20%, transparent);
}

.my-button {
  border-color: var(--my-token);
}
/* use relative color syntax if modifying a base color token with an oklch function */

:root {
  --my-token: oklch(from var(--color-blue-50) l c h / 20%);
}

.my-button {
  border-color: var(--my-token);
}

Autofix functionality

This rule can automatically fix some violations by replacing hex color values with appropriate color names. Border color in the checked properties lists every value it fixes. For example:

/* Before */
.a {
  border-color: #fff;
}

/* After autofix */
.a {
  border-color: white;
}
/* Before */
.a {
  border-color: #ffffff;
}

/* After autofix */
.a {
  border-color: white;
}
/* Before */
.a {
  border-color: #FFF;
}

/* After autofix */
.a {
  border-color: white;
}
/* Before */
.a {
  border-color: #FFFFFF;
}

/* After autofix */
.a {
  border-color: white;
}
/* Before */
.a {
  border-color: #000;
}

/* After autofix */
.a {
  border-color: black;
}
/* Before */
.a {
  border-color: #000000;
}

/* After autofix */
.a {
  border-color: black;
}

System Colors

Using system colors, especially for forced colors or high contrast, is allowed. However, it may be better to use a design system token that already accounts for those situations and avoid needing the extra media query.

/* Good */
@media (prefers-contrast) {
  .a {
    border-color: ButtonBorder;
  }
}

/* Better */
.a {
  border-color: var(--button-border-color);
}