The Design System Team (DST)[0] is preparing to release the next major version of Codex, the design system for Wikimedia. Codex has evolved significantly since the first major version release in late 2023: expanding the toolkit with a number of new components[1], tokens[2] and icons[3], introducing alternative color modes[4], adding a proper i18n system[5], refactoring components to be compatible with native browser validation[6], supporting the creation of a PHP implementation of the component library[7], refreshing the documentation, and (finally) getting a unique logo. With the upcoming introduction of a revised typography scale and customizable font modes[8] along with a handful of other breaking changes, DST has determined this to be an appropriate time for another major version release.
==== Timeline ====
DST plans to first release a release candidate (rc) of version 2.0.0 that will include all known breaking changes. It is anticipated that only one rc version will be released, but if major issues are discovered, there will be additional rcs until the build is considered stable enough to be the official major version.
- v2.0.0-rc.1 will be released on 29 April 2025 and ride the deployment train the week of 5 May 2025 - v2.0.0 will be released on 13 May 2025 and ride the train the week of 19 May 2025
==== Breaking Changes ====
Codex 2.0 will include a number of breaking changes that need to be addressed in downstream code to avoid compatibility issues. These are detailed in full along with guidance on how to prepare for the release at https://www.mediawiki.org/wiki/Codex/Release_Timeline/2.0#Breaking_changes. If you are using Codex for a feature actively deployed in Wikimedia production, please check to see if the breaking changes apply to your code. DST has already opened Phabricator tasks for known areas that need to be updated based on codesearch but this is likely not comprehensive.
Thank you to everyone who has contributed to the development of Codex throughout its 1.0 lifespan! We look forward to seeing its use in Wikimedia projects continue to grow as it further evolves through this next major iteration.
Anne Tomasevich, on behalf of the Design System Team
[0] https://www.mediawiki.org/wiki/Design_System_Team [1] https://doc.wikimedia.org/codex/latest/components/overview.html [2] https://doc.wikimedia.org/codex/latest/design-tokens/overview.html [3] https://doc.wikimedia.org/codex/latest/icons/overview.html [4] https://doc.wikimedia.org/codex/latest/using-codex/adrs/08-adr-color-modes.h... [5] https://doc.wikimedia.org/codex/latest/using-codex/adrs/10-adr-i18n-for-comm... [6] https://doc.wikimedia.org/codex/latest/using-codex/adrs/12-adr-native-constr... [7] https://doc.wikimedia.org/codex/latest/using-codex/adrs/11-adr-codex-php.htm... [8] https://doc.wikimedia.org/codex/latest/using-codex/adrs/13-adr-font-modes.ht... [9] https://codesearch-beta.wmcloud.org/search