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
This is a reminder of the upcoming Codex v2.0.0-rc.1 release scheduled for 29 April 2025, which will ride the train the week of 5 May 2025. This first release candidate will include all known breaking changes. Assuming no major issues are discovered, v2.0.0 will be released on 13 May 2025 and ride the train the week of 19 May 2025.
==== Breaking Changes ====
Developers using Codex are encouraged to check for breaking changes documented at https://www.mediawiki.org/wiki/Codex/Release_Timeline/2.0#Breaking_changes to avoid compatibility issues. Phabricator tasks have already been filed for known areas that need to be updated based on codesearch but this may not be comprehensive.
==== Visual Changes ====
With the exception of some interfaces in MonoBook detailed at https://www.mediawiki.org/wiki/Codex/Release_Timeline/2.0#Visual_changes, readers and editors should not experience any major visual changes as part of this release.
Codex components and interfaces that use Codex design tokens may look slightly different but any changes should be either negligible or improvements. Some potentially noticeable visual changes include: - Dialog titles have increased in size. - Spacing between Checkboxes and Radios within groups has been reduced. - Padding in block-style Messages has been reduced.
The changes to the typography scale will be visible to readers only once Codex font modes are incorporated into the text preferences feature of Vector 2022 (tracked in T391891) and other skins, which will happen at a later time. This change will make interfaces built with Codex appear even more consistent, especially across skins (and text size options in Vector 2022).
A complete picture of the testing effort prior to release is documented in T386298. Issues discovered in beta during testing post-release will be tracked in T392379 and issues discovered as part of the train deployment will be tracked in T392390.
Thank you for your attention,
Anne Tomasevich, on behalf of the Design System Team
Hi all, we can happily report, that Codex v2.0.0-rc.1 has been successfully released and rolled out with MediaWiki v1.45.0-wmf.1 train this Tuesday to be ready for testing on https://en.wikipedia.beta.wmflabs.org/
We would like to repeat that you test your extensions and Codex design tokens, icons or components using interface specifically with Vector client preferences font scaling. Additionally we would like to ask if there are findings and tasks to be filed, to reference them to testing this release on beta https://phabricator.wikimedia.org/T392379
Thanks, Volker E. on behalf of the Design System Team
On Mon, Apr 28, 2025 at 2:12 PM atomasevich@wikimedia.org wrote:
This is a reminder of the upcoming Codex v2.0.0-rc.1 release scheduled for 29 April 2025, which will ride the train the week of 5 May 2025. This first release candidate will include all known breaking changes. Assuming no major issues are discovered, v2.0.0 will be released on 13 May 2025 and ride the train the week of 19 May 2025.
==== Breaking Changes ====
Developers using Codex are encouraged to check for breaking changes documented at https://www.mediawiki.org/wiki/Codex/Release_Timeline/2.0#Breaking_changes to avoid compatibility issues. Phabricator tasks have already been filed for known areas that need to be updated based on codesearch but this may not be comprehensive.
==== Visual Changes ====
With the exception of some interfaces in MonoBook detailed at https://www.mediawiki.org/wiki/Codex/Release_Timeline/2.0#Visual_changes, readers and editors should not experience any major visual changes as part of this release.
Codex components and interfaces that use Codex design tokens may look slightly different but any changes should be either negligible or improvements. Some potentially noticeable visual changes include:
- Dialog titles have increased in size.
- Spacing between Checkboxes and Radios within groups has been reduced.
- Padding in block-style Messages has been reduced.
The changes to the typography scale will be visible to readers only once Codex font modes are incorporated into the text preferences feature of Vector 2022 (tracked in T391891) and other skins, which will happen at a later time. This change will make interfaces built with Codex appear even more consistent, especially across skins (and text size options in Vector 2022).
A complete picture of the testing effort prior to release is documented in T386298. Issues discovered in beta during testing post-release will be tracked in T392379 and issues discovered as part of the train deployment will be tracked in T392390.
Thank you for your attention,
Anne Tomasevich, on behalf of the Design System Team _______________________________________________ Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org To unsubscribe send an email to wikitech-l-leave@lists.wikimedia.org https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/
Hi all–
Codex v2.0.0-rc.2 will ride the train to production https://gerrit.wikimedia.org/r/c/mediawiki/core/+/1148969 this week. There should be very little in the way of noticeable changes compared to RC1.
This is the second (and hopefully final) release candidate for the 2.0 release of Codex https://doc.wikimedia.org/codex/latest/, the design system for Wikimedia. The new release introduces a new line-height token which should make it simplify the process of enabling the new “font modes” feature in the skins at some point in the near future. A full list of changes can be found at in the library changelog https://github.com/wikimedia/design-codex/blob/main/CHANGELOG.md#200-rc2--2025-05-21.
Any bugs noticed during the rollout of RC2 can be reported here: https://phabricator.wikimedia.org/T394833
Thanks,
Eric Gardner & the Design System Team
On May 7, 2025, at 1:30 PM, Volker E. volker.e@wikimedia.org wrote:
Hi all, we can happily report, that Codex v2.0.0-rc.1 has been successfully released and rolled out with MediaWiki v1.45.0-wmf.1 train this Tuesday to be ready for testing on https://en.wikipedia.beta.wmflabs.org/
We would like to repeat that you test your extensions and Codex design tokens, icons or components using interface specifically with Vector client preferences font scaling. Additionally we would like to ask if there are findings and tasks to be filed, to reference them to testing this release on beta https://phabricator.wikimedia.org/T392379
Thanks, Volker E. on behalf of the Design System Team
On Mon, Apr 28, 2025 at 2:12 PM atomasevich@wikimedia.org wrote:
This is a reminder of the upcoming Codex v2.0.0-rc.1 release scheduled for 29 April 2025, which will ride the train the week of 5 May 2025. This first release candidate will include all known breaking changes. Assuming no major issues are discovered, v2.0.0 will be released on 13 May 2025 and ride the train the week of 19 May 2025.
==== Breaking Changes ====
Developers using Codex are encouraged to check for breaking changes documented at https://www.mediawiki.org/wiki/Codex/Release_Timeline/2.0#Breaking_changes to avoid compatibility issues. Phabricator tasks have already been filed for known areas that need to be updated based on codesearch but this may not be comprehensive.
==== Visual Changes ====
With the exception of some interfaces in MonoBook detailed at https://www.mediawiki.org/wiki/Codex/Release_Timeline/2.0#Visual_changes, readers and editors should not experience any major visual changes as part of this release.
Codex components and interfaces that use Codex design tokens may look slightly different but any changes should be either negligible or improvements. Some potentially noticeable visual changes include:
- Dialog titles have increased in size.
- Spacing between Checkboxes and Radios within groups has been reduced.
- Padding in block-style Messages has been reduced.
The changes to the typography scale will be visible to readers only once Codex font modes are incorporated into the text preferences feature of Vector 2022 (tracked in T391891) and other skins, which will happen at a later time. This change will make interfaces built with Codex appear even more consistent, especially across skins (and text size options in Vector 2022).
A complete picture of the testing effort prior to release is documented in T386298. Issues discovered in beta during testing post-release will be tracked in T392379 and issues discovered as part of the train deployment will be tracked in T392390.
Thank you for your attention,
Anne Tomasevich, on behalf of the Design System Team _______________________________________________ Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org To unsubscribe send an email to wikitech-l-leave@lists.wikimedia.org https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/
Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org To unsubscribe send an email to wikitech-l-leave@lists.wikimedia.org https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/
wikitech-l@lists.wikimedia.org