carbon

What Carbon is

Carbon is the open source design system that IBM builds and maintains for its products and digital experiences. The project lives as a monorepo under the carbon-design-system organization on GitHub, and it collects the React and web components libraries, the Sass style definitions, design tokens, icons, pictograms, and the supporting tooling that teams use to build with Carbon. The README describes the repository as the home for these libraries and assets rather than a single packaged product, so a developer can pull individual packages instead of the whole tree. The work is licensed under the Apache 2.0 license, which the README states plainly, and the repository runs continuous integration through GitHub Actions while also carrying an OpenSSF Best Practices badge. The project points to a Discord server and to GitHub Discussions for community conversation. With 9385 stars and 2265 forks recorded in the metadata, Carbon ranks among the more widely adopted design systems on GitHub. The README does not publish a single version number for the repository as a whole because each package is released on its own cadence through npm, and the version badges in the README reflect those per package releases rather than one unified version. The README also links to Storybook instances for the React and web components packages, so a reader can browse the components interactively before adopting them in a project.

Packages and framework support

The README lays out a table of published packages. The core libraries are @carbon/react for React components and styles, and @carbon/web-components for standards based web components. Around them sit utility and foundation packages: @carbon/colors supplies color scales and color token utilities, @carbon/elements holds the IBM Design Language foundations including tokens and assets, and @carbon/grid provides layout built on the Carbon grid. There are also @carbon/icons for icon assets with framework packages, @carbon/layout for spacing scale tokens, @carbon/motion for motion curves, @carbon/pictograms for pictogram assets, @carbon/styles for Sass styles, @carbon/themes for theme tokens, and @carbon/type for type tokens designed to pair with IBM Plex. Each package links to its own source, documentation, and in some cases a Storybook. Beyond the first party packages, the README notes community maintained packages for Angular, Svelte, and Vue, with links to the respective repositories. This structure lets a team adopt Carbon through its preferred framework while still sharing the same tokens, grids, and type scale. The README frames the packages as the building blocks rather than a closed application, and it directs readers to the project website for designing, developing, contributing, and migrating guidance. The icon package in particular ships framework specific builds for React and Vue, which means the same artwork drops into different stacks without re exporting assets for each one.

Contributing and community

Carbon welcomes outside contributions and the README links to a CONTRIBUTING file that explains the guidelines and the expectations the maintainers have for the repository. The community side is split between GitHub Discussions, where people ask questions, share ideas, and connect with other contributors, and a Discord server for chatting with community members. The README reminds readers that a Code of Conduct applies to all Carbon community channels, and it links to that document. A contributors image generated by contrib.rocks is included to show the people who have committed to the project. The repository metadata shows 1016 open issues, which indicates an active issue tracker where bugs, feature requests, and design questions are raised. Because Carbon is a monorepo with many packages, the contribution workflow spans multiple language toolchains, and the README points contributors to the design, develop, and migrate pages on the project website for the deeper guidance they need before opening a pull request. The combination of documented contribution rules, a moderated community space, and continuous integration gives newcomers a clear path to participate, while the OpenSSF badge signals that the project tracks a recognized set of supply chain and security practices across its published packages. The contributor base shown in the generated image reflects steady participation across the many packages in the monorepo.

Editorial conclusion

Carbon is published under the Apache 2.0 license and its most recent commit was on 2026-08-26.