Migration guide

Carbon-themes was deprecated in v10, and the themes package @carbon/themes now lives in the Carbon monorepo.

Carbon components were reskinned in v10. 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 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.

All technical migration docs for Carbon elements are available in the carbon monorepo docs folder.

The @carbon/icons package can be now be found in the Carbon monorepo.

The Carbon icons 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 v10 color token architecture is based on the v9 architecture, with some minor changes to align with the design language. Carbon v9 product teams will see automatic, non-breaking color updates when they upgrade to v10.

The type token architecture was redesigned for better clarity and flexibility. V10 moves from a basic type scale model to a more robust token-based architecture.

Token names changed in v10 but spacing values did not.

Carbon adheres to IBM Design Language motion standards. Motion updates should be coordinated with your product’s design team.