https://github.com/carbon-design-system/ibm-products
A Carbon-powered React and Web Component library for IBM Products
https://github.com/carbon-design-system/ibm-products
carbon-design-system design-system hacktoberfest ibm-products javascript react scss web-components
Last synced: 2 days ago
JSON representation
A Carbon-powered React and Web Component library for IBM Products
- Host: GitHub
- URL: https://github.com/carbon-design-system/ibm-products
- Owner: carbon-design-system
- License: apache-2.0
- Created: 2020-06-16T16:16:12.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-04-09T16:07:00.000Z (5 days ago)
- Last Synced: 2025-04-09T17:25:18.971Z (5 days ago)
- Topics: carbon-design-system, design-system, hacktoberfest, ibm-products, javascript, react, scss, web-components
- Language: JavaScript
- Homepage: https://ibm-products.carbondesignsystem.com
- Size: 1.24 GB
- Stars: 103
- Watchers: 20
- Forks: 153
- Open Issues: 363
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
- Support: .github/SUPPORT.md
Awesome Lists containing this project
- jimsghstars - carbon-design-system/ibm-products - A Carbon-powered React component library for IBM Products (JavaScript)
README
# Carbon for IBM Products
> Carbon for IBM Products is an open source implementation of the closed source
> [IBM Software pattern asset library (PAL)](https://pages.github.ibm.com/carbon/ibm-products/).
> These PAL designs build on the foundation of IBM’s open source Carbon Design
> System and React implementation to offer components and patterns beyond the
> typical component library. Carbon for IBM Products was previously known as
> Carbon for Cloud and Cognitive, and this name can still be encountered in
> various places and historical logs.
[](#contributors-)
[](https://github.com/carbon-design-system/ibm-products/blob/master/LICENSE)
[](https://github.com/carbon-design-system/ibm-products/actions/workflows/ci.yml)
[](https://app.netlify.com/sites/carbon-for-ibm-products/deploys)
[](https://lerna.js.org)
[](https://github.com/carbon-design-system/ibm-products/blob/master/.github/CONTRIBUTING.md)
[](https://codecov.io/gh/carbon-design-system/ibm-products)
## 🚀 Getting started
If you’re just getting started and looking to browse our React components, take
a look at [our Storybook](https://ibm-products.carbondesignsystem.com).
All of our source code and documentation, including this readme, can be found on
[our GitHub repo](https://github.com/carbon-design-system/ibm-products), which
is also the place to
[open issues](https://github.com/carbon-design-system/ibm-products/issues/new/choose)
if you have a problem or find a defect or would like to request a new feature or
change something.
If you have access to the IBM Slack workspaces, join
[our Slack channel](https://ibm-casdesign.slack.com/archives/C013ZTX0N6B) where
you can ask questions, report problems, and get help from the team and from
other users.
This project consists of a number of component library packages published on
npm:
| Package name | Description |
| ---------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| [`@carbon/ibm-products`](./packages/ibm-products) | A curated set of components and patterns, built on top of Carbon and designed by the Carbon for IBM Products team |
| [`@carbon/ibm-cloud-cognitive-cdai`](https://github.com/carbon-design-system/ibm-products/tree/v1/packages/cdai) | (**v1 only**) Legacy and non-curated design implementations used in application integration |
| [`@carbon/ibm-security`](https://github.com/carbon-design-system/ibm-products/tree/v1/packages/security) | (**v1 only**) Legacy and non-curated design implementations used in security |
Also the following additional utility packages are published on npm:
| Package name | Description |
| ------------------------------------------------------------------------ | ------------------------------------------------- |
| [`@carbon/storybook-addon-theme`](./config/storybook-addon-carbon-theme) | A storybook addon enabling Carbon theme switching |
The remaining packages are part of our project infrastructure and are not
published on npm.
### Version support
Carbon 11 support is introduced in Carbon for IBM Products
| Package name | Carbon package | React version |
| ---------------------- | ------------------- | ------------- |
| `@carbon/ibm-products` | **`@carbon/react`** | 18, 17, 16 |
The following packages support Carbon 10 and are considered
packages.
| Package name | Carbon package | React version |
| ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| `@carbon/ibm-products`
`@carbon/ibm-cloud-cognitive-cdai`
`@carbon/ibm-security`
| **`carbon-components-react`**
`carbon-components`
`@carbon/icons-react`
`@carbon/icons`
`@carbon/colors`
`@carbon/elements`
etc | 17, 16 |
If you’d like to learn more about migrating from Carbon 10 to Carbon 11, please
see the Carbon
[v11 migration guide](https://github.com/carbon-design-system/carbon/blob/main/docs/migration/v11.md)
(which includes codemods via
[`@carbon/upgrade`](https://github.com/carbon-design-system/carbon/blob/main/packages/upgrade/README.md))
and the Carbon for IBM Products
[v2 migration guide](https://github.com/carbon-design-system/ibm-products/blob/main/docs/guides/v2.md).
## 🙌 Contributing
This project is made possible by several community members who have invested
their precious time to give back to the Carbon community. It will continue to be
possible by having those that benefit from the package contribute back to it.
So, do not be shy. We both depend on and appreciate contributors, new and old,
who help us fix bugs, build new features, improve our documentation, etc.
This repository is a monorepo and contains multiple packages so be sure to check
the relevant package for any package-specific guidance.
- [@carbon/ibm-products](https://github.com/carbon-design-system/ibm-products/blob/master/.github/CONTRIBUTING.md)
- [@carbon/ibm-cloud-cognitive-cdai](./packages/cdai)
- [@carbon/ibm-security](./packages/security)
Read also our
[Contributing Guide](https://github.com/carbon-design-system/ibm-products/blob/master/.github/CONTRIBUTING.md)
and
[Carbon’s Developer Handbook](https://github.com/carbon-design-system/carbon/blob/master/docs/developer-handbook.md)!
👀
## Contributors ✨
Thanks goes to these wonderful people
([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Simon Finney
💻
Lee Chase
💻 💡 👀 🚇
Simon Moore
💻
Josh Black
💻
David Menendez
💻 👀 ️️️️♿️
vladbalanescu
💻
Matthew Gallo
💻 🚇 👀
Matt Chapman
💻
Dominik Brugger
💻
Polina Olemskaia
💻
Alexander Melo
💻
Ratheesh Rajan
💻 👀
Jan Hassel
💻 ️️️️♿️
marion-bruells
🎨
Jagath Jayakumar
💻
Laura Marshall
🎨
Drew Glapa
💻
Lily
💻
Marienella Gallo
💻
Shelley Dignum
🎨
Sam Ting
️️️️♿️ 🎨
Paul Balchin
💻
Jeff Longshore
💻
Krista Starr
️️️️♿️ 💻
Mike Olasov
🎨
PUNNOOSE WILSON
💻
SeonyuK
️️️️♿️ 💻
Elysia
💻 🚇 👀
Afsal K
💻
Nandan Devadula
💻
Anamika T S
💻
Sinta Augustine
💻
Austin
💻
Amal K Joy
💻
Anna Wen
💻 🚇
Ariella Gilmore
💻
Bill Keese
💻
This project follows the
[all-contributors](https://github.com/kentcdodds/all-contributors)
specification. Contributions of any kind welcome!
## 📝 License
Licensed under the
[Apache-2.0 License](https://github.com/carbon-design-system/ibm-products/blob/master/LICENSE).
[](https://www.netlify.com)