Skip to content

chore: Update all design tokens suffixes to be value-stable - #4898

Merged
avinashbot merged 1 commit into
mainfrom
stable-tokens
Aug 13, 2026
Merged

chore: Update all design tokens suffixes to be value-stable#4898
avinashbot merged 1 commit into
mainfrom
stable-tokens

Conversation

@avinashbot

@avinashbot avinashbot commented Aug 12, 2026

Copy link
Copy Markdown
Member

Description

Update all design token suffixes. Previously did it in small batches (border, typography, some colors) but there have been no adverse affects to updating these token names. See #4718, #4845, #4860.

All design token CSS variables have a random hash that depends on two things: token name and token values. This means that if we change a value, the token hash changes completely. This makes the token more subject to change and dependent on the exact commit of the components repo — we wanted this before, but not anymore. Now, the CSS variable suffix depends on: token name and major version ("v3-1"). This means that the suffix only really changes if we change the major version suffix, which makes it more stable across different consumers pulling slightly different versions of the package. See Chorus: rzZV6TJY6Zav

Related links, issue #, if available: n/a

How has this been tested?

Updated some unit tests. I'll run a dry-run before I merge.

Review checklist

The following items are to be evaluated by the author(s) and the reviewer(s).

Correctness

  • Changes include appropriate documentation updates.
  • Changes are backward-compatible if not indicated, see CONTRIBUTING.md.
  • Changes do not include unsupported browser features, see CONTRIBUTING.md.
  • Changes were manually tested for accessibility, see accessibility guidelines.

Security

Testing

  • Changes are covered with new/existing unit tests?
  • Changes are covered with new/existing integration tests?

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@codecov

codecov Bot commented Aug 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.64%. Comparing base (912524b) to head (be02535).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #4898   +/-   ##
=======================================
  Coverage   97.64%   97.64%           
=======================================
  Files         958      958           
  Lines       31247    31247           
  Branches    11536    11537    +1     
=======================================
  Hits        30510    30510           
+ Misses        730      690   -40     
- Partials        7       47   +40     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@avinashbot
avinashbot added this pull request to the merge queue Aug 13, 2026
Merged via the queue into main with commit d1e4b15 Aug 13, 2026
61 checks passed
@avinashbot
avinashbot deleted the stable-tokens branch August 13, 2026 13:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants