This update brings development and design into closer alignment, resulting in more consistent theme behavior and improved reliability across all components. It includes multiple bug fixes and overall improvements that make multi-theming more robust and predictable.
What’s changed:
- Token naming has been streamlined and standardized, creating a cleaner and more intuitive experience. This update aligns more closely with Figma, ensuring better consistency between design and implementation.
- As part of this process, some CSS variables previously used for custom theming have been removed. Multi-theming is now more robust, with improved structure and fewer edge cases.
- Documentation has also been enhanced. Based on user feedback, we’ve improved the guidance around multi-theming and its implementation, aiming to make the overall experience as smooth and straightforward as possible.
Important for Developers:
Breaking changes related to the removed theming variables will be introduced in a future release (date to be announced).
- Deprecated variables are still functional
- They are clearly marked in the documentation
- Recommended replacements are provided
Upcoming changes to package compatibility:
Currently, any version of the components and styles packages is compatible with any version of the tokens package. This will change in a future release. A minimum dependency requirement will be introduced:
- The tokens package version will need to be equal to or higher than the components and styles versions
We strongly recommend starting the migration process early to avoid future issues — read the full documentation and learn more about dependency changes.