Problem

The layout, typography and custom elements that –together with WiKit components – make up Mismatch Finder's UI were styled (in most cases) using WiKit tokens.

The WiKit design system is now on its deprecation path, as it has been superseded by Codex, the now official Wikimedia design system. WiKit tokens will be deprecated together with the legacy system, and thus their use is not advised.

Solution

We need to import Codex tokens and use them to replace the WiKit tokens (of all global, aliases and component types) that were used to style Mismatch Finder. This will take us a step closer to switching to the new design system and deprecating the old.

Here's a list of WiKit tokens and their equivalent Codex styles.

Considerations

• Layout and Spacing styles: Unfortunately, $dimension-layout tokens (which have rem values) and $dimension-spacing (which use em values) do not have an equivalent style in Codex. We'll need to use custom variables to replace these (see T346261)

• The task's goal is to replace WiKit tokens in use in the Mismatch Finder app's Sass files. Nevertheless, we should consider the stretch goal of improving the token coverage by replacing discrete values too, if detected.

• We'll have to recreate/replace _typography.scss and instead use Codex tokens.

Acceptance criteria

• All the WiKit tokens used to style the Mismatch Finder app that have an equivalent in Codex are replaced (See T352304, T352311 and T352314)
• WiKit tokens used to style the Mismatch Finder app that don't have an equivalent in Codex are replaced by custom variables (T350189)