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