adobe / adobe/spectrum-design-data
Old static transparency tokens deprecation
- 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
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