What to use instead
Use the latest stable version of React, v19.2 at the time of this writing.
The Carbon team recommends continually investing in your project’s toolchain. Practicing good dependency hygiene and keeping your infrastructure up to date helps create a more stable and secure environment when building with Carbon.
Migration
Refer to the official React 19 Upgrade Guide. If you’re not already on v18.3+, the react team recommends updating to that version before migrating to v19.
If updating to v18, refer to the official React 18 Upgrade Guide.
React v18 and v19 have been available for over 4 years, and 2 years, respectively.
Reconsider your React version blockers
If you attempted to update your React version between 2022-2025 and ran into blockers, those blockers should be reassessed. Agentic tooling has advanced significantly, and migrations that previously required large, sustained effort may now be far more tractable.
Carbon’s migration from Enzyme to React Testing Library, for example, took well over a year in 2022. With today’s tooling, that same type of migration could likely be completed in a couple afternoons by a strong developer working with a capable agent.
What to use instead
carbon-components is replaced by @carbon/styles, but most projects don’t need to install @carbon/styles directly.
If you’re using @carbon/react or @carbon/web-components, you do not need to install @carbon/styles. All @carbon/styles assets are already available to you through those framework-specific packages.
Library authors should use @carbon/styles if they do not already rely on a framework-variant package such as @carbon/react.
Migration
For those using carbon-components@10.x, the v11 migration guide has all the details of how to update.
For those using carbon-components@11.x, these versions are already a direct re-export of @carbon/styles. See the above section on what to use instead.
For questions regarding this deprecation or how to migrate, contact us.
Migration
For those using carbon-components@10.x, the v11 migration guide has all the details of how to update.
For those using carbon-components@11.x, these versions are already a direct re-export of @carbon/styles. See the above section on what to use instead.
For questions regarding this deprecation or how to migrate, contact us.
Migration
For those using carbon-components@10.x, the v11 migration guide has all the details of how to update.
For questions regarding this deprecation or how to migrate, contact us.
Migration
For those using carbon-components@10.x, the v11 migration guide has all the details of how to update.
For questions regarding this deprecation or how to migrate, contact us.
