v3 to v4
v3 to v4
This migration guide outlines the key changes from version 3 to version 4, specifically resolving the deprecation of certain icons.
Icons
In preparation for a bigger overhaul to our Cosmos Icon library we have decided to deprecate some of our arrow-related icons. This decision is part of our effort to reintroduce them with more fitting names, providing some with more semantic names and others with a broader, generalized meaning.
Deprecated 🚫 | Successor ✅ |
|---|---|
cosmos-icon-arrow-up | cosmos-icon-chevron-up |
cosmos-icon-arrow-down | cosmos-icon-chevron-down |
cosmos-icon-arrow-left | cosmos-icon-chevron-left |
cosmos-icon-arrow-right | cosmos-icon-chevron-right |
cosmos-icon-arrow-triangle-left | cosmos-icon-caret-left |
cosmos-icon-arrow-triangle-right | cosmos-icon-caret-right |
cosmos-icon-collapse | cosmos-icon-caret-down |
cosmos-icon-expand | cosmos-icon-caret-up |
cosmos-icon-collapse-arrows | cosmos-icon-collapse-vertical |
cosmos-icon-expand-arrows | cosmos-icon-expand-vertical |
cosmos-icon-expand-more | cosmos-icon-caret-up |
cosmos-icon-expand-less | cosmos-icon-expand |
cosmos-icon-size-contract | cosmos-icon-contract |
cosmos-icon-size-expand | cosmos-icon-enlarge |
cosmos-icon-arrow-down-up | cosmos-icon-sort |
cosmos-icon-arrow-return-right | cosmos-icon-redo |
cosmos-icon-arrow-return-left | cosmos-icon-undo |
Select
Due to a refactoring of the Select component, there is a risk of content resets in Figma projects. Follow these steps to ensure a smooth migration: 1. Review & Update Existing Components: Before applying all updates, check any instances of Select and its values, placeholders in input fields, the dropdown and option items. 2. For affected instances, manually re-apply custom overrides and ensure that properties have been shifted from the select level to the dropdown and option-item levels.