Page MenuHomePhabricator

Align iOS and Android colors with Codex
Open, LowPublic

Description

⚠️ 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 codeOld iOS nameCodex name
#000000color-blackblack
#3366cccolor-blue-600blue700
#f8f9facolor-gray100gray50
#eaecf0color-gray200gray100
#c8ccd1color-gray300gray300
#a2a9b1color-gray400gray400
#72777dcolor-gray500gray500
#54595dcolor-gray600gray600
#27292dcolor-gray675gray800
#202122color-gray700gray900
#101418color-gray800gray1000
#ffffffcolor-whitewhite
iOS colors without overlap in Codex

These colors are unique to iOS and do not overlap with Codex:

Hex codeOld iOS nameUpdate to Codex color
#eaf3ffcolor-blue-100blue200
#6699ffcolor-blue-300blue600
#2a4b8dcolor-blue-700blue800
#2e3136color-gray650gray700
#00af89color-green-600green500
#ff9500color-orangeorange400
#dd3333color-red-600red600
#b32424color-red-700red800
#ffcc33color-yellow-600yellow200
Android colors (Figma) with overlap in Codex

The following Android colors overlap with Codex:

Hex codeOld Android nameCodex name
#000000blackblack
#3366ccblue600blue700
#f8f9fagray100gray50
#eaecf0gray200gray100
#c8ccd1gray300gray300
#a2a9b1gray400gray400
#72777dgray500gray500
#54595dgray600gray600
#27292dgray675gray800
#202122gray700gray900
#ffffffwhitewhite
Android colors without overlap in Codex

These colors are unique to Android and do not overlap with Codex:

Hex codeOld Android nameUpdate to codex color
#6699ffblue300blue600
#2e3136gray650gray700
#00af89green600green500
#14866dgreen700green500
#ff9500orange500orange400
#ff4242red500red600
#b32424red700red800
#ffcc33yellow500yellow200
#ac6600yellow700yellow700
App sepia colors
Hex codeiOS nameAndroid name
#f8f1e3color-beige100beige100
#f0e6d6color-beige300beige300
#e1dad1color-beige400beige400
#cbc8c1taupe200taupe200
#646059taupe600taupe600
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:

AdditionsRemovals
blue600yellow200
References

Event Timeline

@scblr please be sure to update the task above to reflect syntax highlighting vs. revision highlighting in this section:

Syntax highlight suggestions

@scblr thanks for doing this audit. To make it easier to compare hex values (which Phab doesn't easily support) I created a Google Sheet to see the proposed Codex colors next to the current app colors.

I compared DeltaE values for some of the color change propositions you have vs. Codex colors that are more similar to the current colors.

@scblr + @SChekfa-WMF it'd be great if you could each audit color usage per app to ensure that the proposed colors will work with current components, etc.