Repo architecture

Carbon-themes has been deprecated in v10, as the carbon-elements repository now contains the themes package @carbon/themes.

Carbon-icons has not yet been deprecated in favor of @carbon/icons. That is expected to happen in an upcoming dot release.

Migration tooling

Coming soon! carbon-upgrade is a new tool to help developers upgrade to v10 through the command line. This tool is still experimental, and if you would like to contribute, the Carbon team would welcome the help! Please leave ideas for migration tooling here.

Carbon components

Carbon components have been completely re-skinned for the new IBM Design Language. The redesign was conducted with maximum backwards-compatibility in mind. Users of v9 should be able to upgrade to v10 automatically with minimal breakage.


Detailed technical migration docs for Carbon vanilla components are available in the carbon-components repo. Here you will find links to component-level migration information, as well as a list of those components that have been removed or are under development.

There is also a dedicated Sass migration guide that covers changes to global styling.


React-specific technical migration docs are available here.

Carbon Elements

All technical migration docs for the carbon-elements repo are available in the repo’s docs folder.


Carbon icons underwent a major update for v10. The @carbon/icons package can be now be found in the Carbon Elements repo. The carbon-icons repo that was used in previous releases of Carbon has been deprecated.

See the icons migration table to view .

The Carbon Icons ESM Demo contains a master table for all Carbon icons, including name, size, preview, download links, quick links for filing issues, module name, and relative path.


The color token architecture for v10 is based on the v9 architecture, with some minor updates for the new design language. Carbon v9 users will see automatic, non-breaking color updates when they upgrade to v10.


The type token architecture has been completely redesigned for better clarity and flexibility in v10, moving from a basic type scale model to a more robust token-based architecture.

Layout, Grid, Spacing

Spacing values will see no change from Carbon v9, though the token names have changed.


Motion standards have been revised to meet the new IBM Design Language standards. Motion updates should be coordinated with your product’s design team if possible.


To leave feedback for the Carbon team about this documentation, make suggestions for improvements, or just ask a question, you can open an issue on GitHub.

Last updated: 29 March 2019