adobe / adobe/spectrum-design-data

Old static transparency tokens deprecation

Open
#1,346 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Rust
Stars
153
Forks
35
Avg merge
7h 54m
Merged PRs (30d)
111

Description

### Token changes

| Change type | Token name | New name / value / replacement | Modes / themes |
| --- | --- | --- | --- |
| Deprecate | transparent-white-25 | transparent-static-white-0 | Light, Dark, Wireframe |
| Deprecate | transparent-white-50 | transparent-static-white-100 | Light, Dark, Wireframe |
| Deprecate | transparent-white-75 | transparent-static-white-150 | Light, Dark, Wireframe |
| Deprecate | transparent-white-100 | transparent-static-white-200 | Light, Dark, Wireframe |
| Deprecate | transparent-white-200 | transparent-static-white-300 | Light, Dark, Wireframe |
| Deprecate | transparent-white-300 | transparent-static-white-300 | Light, Dark, Wireframe |
| Deprecate | transparent-white-400 | transparent-static-white-350 | Light, Dark, Wireframe |
| Deprecate | transparent-white-500 | transparent-static-white-600 | Light, Dark, Wireframe |
| Deprecate | transparent-white-600 | transparent-static-white-700 | Light, Dark, Wireframe |
| Deprecate | transparent-white-700 | transparent-static-white-800 | Light, Dark, Wireframe |
| Deprecate | transparent-white-800 | transparent-static-white-900 | Light, Dark, Wireframe |
| Deprecate | transparent-white-900 | transparent-static-white-950 | Light, Dark, Wireframe |
| Deprecate | transparent-white-1000 | transparent-static-white-1000 | Light, Dark, Wireframe |
| Deprecate | transparent-black-25 | transparent-static-black-0 | Light, Dark, Wireframe |
| Deprecate | transparent-black-50 | transparent-static-black-75 | Light, Dark, Wireframe |
| Deprecate | transparent-black-75 | transparent-static-black-125 | Light, Dark, Wireframe |
| Deprecate | transparent-black-100 | transparent-static-black-150 | Light, Dark, Wireframe |
| Deprecate | transparent-black-200 | transparent-static-black-200 | Light, Dark, Wireframe |
| Deprecate | transparent-black-300 | transparent-static-black-300 | Light, Dark, Wireframe |
| Deprecate | transparent-black-400 | transparent-static-black-400 | Light, Dark, Wireframe |
| Deprecate | transparent-black-500 | transparent-static-black-700 | Light, Dark, Wireframe |
| Deprecate | transparent-black-600 | transparent-static-black-750 | Light, Dark, Wireframe |
| Deprecate | transparent-black-700 | transparent-static-black-800 | Light, Dark, Wireframe |
| Deprecate | transparent-black-800 | transparent-static-black-900 | Light, Dark, Wireframe |
| Deprecate | transparent-black-900 | transparent-static-black-950 | Light, Dark, Wireframe |
| Deprecate | transparent-black-1000 | transparent-static-black-1000 | Light, Dark, Wireframe |
| Deprecate | white | transparent-static-white-1000 | Light, Dark, Wireframe |
| Deprecate | black | transparent-static-black-1000 | Light, Dark, Wireframe |

### Platform target

- [x] S2 Web
- [ ] iOS
- [ ] Android
- [ ] All platforms

### Motivation and context

Deprecate the existing transparent-white-*, transparent-black-*, white, and black transparency tokens in favor of the new transparent-static-white-* and transparent-static-black-* token families.

The new token taxonomy provides a consistent opacity scale, aligns token naming with token intent, and standardizes transparent color values across Spectrum. Deprecating the legacy tokens reduces duplication, improves discoverability, and establishes a clear migration path to the new transparency token set.

[Tokens for AI Brand_Opacity-Transparency_Final.xlsx](https://github.com/user-attachments/files/31218214/Tokens.for.AI.Brand_Opacity-Transparency_Final.xlsx)

### Migration guidance — Deprecate / Rename

Migrate all usages of transparent-white-* and transparent-black-* to the replacement transparent-static-* tokens listed in this proposal. Replace white with transparent-static-white-1000 and black with transparent-static-black-1000. Some replacements are approximate matches to align with the new opacity scale.

### Known consuming components

Used across multiple Spectrum components. A complete consumer audit has not yet been performed due to deadline. Please verify downstream references during migration.

### Links or screenshots from the S2 Token specs

_No response_

### Deadline / linked issue or epic

Needed by Aug 20 (AI Branding work)

Contributor guide

Open the contributing guide

Research direction

No source files or tests are named. Start by auditing Spectrum component references to the listed legacy tokens, using the issue’s replacement table as the migration map. Verify S2 Web usage across Light, Dark, and Wireframe themes; done means known consumers use the replacement token families and no listed legacy references remain.

Written by the indexing model from the issue text.

Assessment

Domain
design
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.