⚠️ WORK IN PROGRESS
Background/Goals
- This task focuses on auditing and updating color usage across iOS and Android apps to align with the Codex design system. The primary goal is to adopt Codex tokens where applicable.
- The sepia colors are unique to the apps, so the goal is to identify if these should also be adopted.
- Define diff colors for iOS and Android
- Nice to have: Define consistent syntax highlighting between iOS and Android.
User stories
- As a designer, I want the colors across iOS and Android apps to align with Codex to maintain consistency and improve design coherence.
- As a developer, I want unified color names and tokens to reduce confusion and facilitate code maintenance.
- As a user, I want an accessible and visually appealing app experience.
Tasks
Audit and alignment
- Audit the iOS and Android colors against the Codex (@scblr)
- Align color names and tokens on iOS and Android with Codex (@scblr)
- List colors with overlapping hex codes between iOS, Android, and Codex (@scblr)
- List colors unique to each platform that do not overlap with Codex (@scblr)
- Suggest updates to colors unique to each platform to match Codex (@scblr)
- List the sepia app colors in the task (@scblr)
- Should sepia colors align with Codex? (discuss!)
- Thoughts on the diff color suggestions? (discuss!)
- Update color definitions for (Android)
- Update color definitions for iOS
Implementation
- Update iOS color tokens to match Codex naming conventions.
- Update Android color tokens to match Codex naming conventions.
- Resolve overlaps by renaming or replacing existing colors with Codex equivalents.
- Update syntax highlighting to align with Codex and maintain platform consistency.
Timeline
- January 27, 2025: Share project brief with teams.
- February 24, 2025: Complete color audits for iOS and Android.
- March 10, 2025: Update color tokens and resolve overlaps.
- March 24, 2025: Finalize implementation and documentation.
Audit
iOS colors (Figma) with overlap in Codex
The following iOS colors overlap with Codex:
| Hex code | Old iOS name | Codex name |
|---|---|---|
| #000000 | color-black | black |
| #3366cc | color-blue-600 | blue700 |
| #f8f9fa | color-gray100 | gray50 |
| #eaecf0 | color-gray200 | gray100 |
| #c8ccd1 | color-gray300 | gray300 |
| #a2a9b1 | color-gray400 | gray400 |
| #72777d | color-gray500 | gray500 |
| #54595d | color-gray600 | gray600 |
| #27292d | color-gray675 | gray800 |
| #202122 | color-gray700 | gray900 |
| #101418 | color-gray800 | gray1000 |
| #ffffff | color-white | white |
iOS colors without overlap in Codex
These colors are unique to iOS and do not overlap with Codex:
| Hex code | Old iOS name | Update to Codex color |
|---|---|---|
| #eaf3ff | color-blue-100 | blue200 |
| #6699ff | color-blue-300 | blue600 |
| #2a4b8d | color-blue-700 | blue800 |
| #2e3136 | color-gray650 | gray700 |
| #00af89 | color-green-600 | green500 |
| #ff9500 | color-orange | orange400 |
| #dd3333 | color-red-600 | red600 |
| #b32424 | color-red-700 | red800 |
| #ffcc33 | color-yellow-600 | yellow200 |
Android colors (Figma) with overlap in Codex
The following Android colors overlap with Codex:
| Hex code | Old Android name | Codex name |
|---|---|---|
| #000000 | black | black |
| #3366cc | blue600 | blue700 |
| #f8f9fa | gray100 | gray50 |
| #eaecf0 | gray200 | gray100 |
| #c8ccd1 | gray300 | gray300 |
| #a2a9b1 | gray400 | gray400 |
| #72777d | gray500 | gray500 |
| #54595d | gray600 | gray600 |
| #27292d | gray675 | gray800 |
| #202122 | gray700 | gray900 |
| #ffffff | white | white |
Android colors without overlap in Codex
These colors are unique to Android and do not overlap with Codex:
| Hex code | Old Android name | Update to codex color |
|---|---|---|
| #6699ff | blue300 | blue600 |
| #2e3136 | gray650 | gray700 |
| #00af89 | green600 | green500 |
| #14866d | green700 | green500 |
| #ff9500 | orange500 | orange400 |
| #ff4242 | red500 | red600 |
| #b32424 | red700 | red800 |
| #ffcc33 | yellow500 | yellow200 |
| #ac6600 | yellow700 | yellow700 |
App sepia colors
| Hex code | iOS name | Android name |
|---|---|---|
| #f8f1e3 | color-beige100 | beige100 |
| #f0e6d6 | color-beige300 | beige300 |
| #e1dad1 | color-beige400 | beige400 |
| #cbc8c1 | taupe200 | taupe200 |
| #646059 | taupe600 | taupe600 |
Diff color suggestions
Use yellow and blue for removals and additions (example from Desktop Wikipedia). Desktop uses:
- #A3D3FF (blue) for additions
- #FFE49C (yellow) for removals
Codex suggestions for apps:
| Additions | Removals |
|---|---|
| blue600 | yellow200 |