Problem
The Mismatch Finder's user interface was composed using a combination of Vue 2 custom components and WiKit elements, such as Link. The WiKit design system is now on its deprecation path, as it has been superseded by Codex, the official Wikimedia design system. The utilization of WiKit components is not recommended, and they should be replaced in order to reduce maintenance costs and ensure consistency.
Solution
We have to replace WiKit's Link component by the Codex equivalent. Unfortunately, Codex right now provides links as a Less mixin (cdx-mixin-link) that we can't reuse in Sass. The team is not planning to provide a preprocessor independent solution. Our way around this could be to either update our Link mixin or create our own classes using Sass Codex variables.
In Mismatch finder, some links were created using the link component, while others actually consist of text styled using a link mixin defined in a typography Sass file. Here are some examples of the former, the components that need replacement:
| Main page | Results page |
|---|---|
| Header and footer links: | Results and Mismatch row: |
Considerations:
- Header's user link: Following the documentation, Codex Links cannot include a start icon, only a trailing one. We'll remove the icon displayed in the profile link to simplify migration.
Acceptance criteria
- All WiKit links in the Mismatch Finder UI and components are replaced by their Codex equivalent








