React components for the Carbon Design System
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci ci: switch from Travis to CircleCI (#1551) Nov 12, 2018
.github fix: run prettier to fix issues with new md (#1872) Feb 14, 2019
.storybook chore: Update webpack and swap out minifier (#1560) Nov 14, 2018
.yarn-offline-mirror chore: bump icons dependency (#1884) Feb 15, 2019
config Update babel to v7 (#1309) Sep 13, 2018
docs docs(build): update instruction on building carbon-coponents style (#… Feb 15, 2019
examples docs(examples): usage of react-router, resolves #795 (#1797) Feb 8, 2019
scripts fix(build): fix broken UMD build (#1625) Dec 18, 2018
src feat: allow tabs to accept any react node (#1886) Feb 15, 2019
ssr-tests [RFC] Update folder structure (#303) Nov 6, 2017
storybook-static-preview chore(build): supporting experimental for deploy preview (#1711) Jan 11, 2019
.aat.yml a11y testing for all components Jan 16, 2017
.all-contributorsrc fix(data-table): update skeleton for IE11 compatibility (#1531) Nov 9, 2018
.cfignore chore: add staticfile and cfignore for deploys (#387) Dec 1, 2017
.editorconfig Search (#38) Aug 3, 2016
.gitignore chore(build): supporting experimental for deploy preview (#1711) Jan 11, 2019
.prettierignore docs: move docs to github folder, update instructions (#651) Mar 1, 2018
.yarnrc chore: add prune config for Yarn in the offline mirror (#1190) Aug 15, 2018
LICENSE chore(license): add LICENSE file and update field in package.json (#269) Oct 11, 2017
README.md docs(Storybook): more detailed doc for using our Storybook (#1809) Feb 1, 2019
Staticfile chore: add staticfile and cfignore for deploys (#387) Dec 1, 2017
netlify.toml chore(build): supporting experimental for deploy preview (#1711) Jan 11, 2019
package.json chore: bump icons dependency (#1884) Feb 15, 2019
yarn.lock chore: bump icons dependency (#1884) Feb 15, 2019

README.md

Carbon Components React

CircleCI All Contributors Greenkeeper badge

A collection of Carbon Components implemented using React.

Usage

List of Available Components

View available React Components here. You can see usage information in several ways:

  1. Clicking the blue Show Info icon in the top right corner of the selected component. You can see the list of available React props
  2. Clicking the STORY tab at the bottom. This tab contains the code that shows how the component is being used
  3. Clicking the KNOBS tab at the bottom and changing values there. Most knobs are shown as something like Button kind (kind), where kind is the name of React prop
  4. Clicking the ACTION LOGGER tab at the bottom and interacting with the selected component. You may see something like onClick which typically indicates that the event handler (React prop) with the same name is called. You can also expand the twistie to see the details of the event
  5. Clicking the README tab at the bottom. You can see some more document for some components

Getting Started

Run the following command using npm:

npm install -S carbon-components-react carbon-components carbon-icons

If you prefer Yarn, use the following command instead:

yarn add carbon-components-react carbon-components carbon-icons
  1. These components require the use of Webpack in your project. See our webpack.config.js for an example configuration.

  2. Components do not import any of the styles themselves, use the scss or css from carbon-components to bring in styling. You can also use the unpkg cdn to bring in the styles wholesale - unpkg.com/carbon-components/css/carbon-components.css aliases the latest css file.

  3. For older browsers (e.g. IE11), polyfills listed in carbon-components-react/.storybook/polyfills.js file is required.

If you just want to try out carbon-components-react, you can also use CodeSandbox.

Edit carbon-components-react

Development

Please refer to the Contribution Guidelines before starting any work.

Using the server

We recommend the use of React Storybook for developing components.

  1. (Optional) Set environment variables:

    • true to CARBON_USE_EXPERIMENTAL_FEATURES environment variable to test some of the experimental features:

      $ export CARBON_USE_EXPERIMENTAL_FEATURES=true
      
    • true to CARBON_REACT_STORYBOOK_USE_EXTERNAL_CSS environment variable to use external CSS, making style source link usable in DOM inspector:

      $ export CARBON_REACT_STORYBOOK_USE_EXTERNAL_CSS=true
      
    • true to CARBON_REACT_STORYBOOK_USE_STYLE_SOURCEMAP environment variable to use Sass source map, making style source link point to the original Sass code:

      $ export CARBON_REACT_STORYBOOK_USE_STYLE_SOURCEMAP=true
      

Caveats:

  • CARBON_REACT_STORYBOOK_USE_EXTERNAL_CSS=true and CARBON_REACT_STORYBOOK_USE_STYLE_SOURCEMAP=true make WebPack builds slightly slower.
  • With CARBON_REACT_STORYBOOK_USE_STYLE_SOURCEMAP=true, the source map (hitting style source link in DOM inspector) sometimes leads you to a mix-in, instead of a style rule calling the mix-in, which may get you lost.
  1. Start the server:

    $ yarn storybook
    
  2. Open browser to http://localhost:9000/.

  3. Develop components in their respective folders (/components or /internal).

  4. Write stories for your components in /.storybook.

Contributing

Please check out our Contribution Guidelines for detailed information on how you can lend a hand.

To update the Contributors section, follow these instructions

Contributors

Thanks goes to these wonderful people:


Brian Han

💻

Chris Dhanaraj

💻

Nick Sandonato

💻

TJ Egan

💻

Mari Johannessen

💻

Sam Doyle

💻

alex weidner

💻

Ciaran Hannigan

💻

Ian Fleming

💻

Eddie Monge

💻

Reinaldo Cruz

💻

Yu Cao

💻

Megan Becvarik

💻

Astha

💻

Jason Lengstorf

💻

Nathan Friedly

💻

Matt Hamann

💻

Greg

💻

Anthony Oliveri

💻

Jorge Padilla

💻

German Attanasio

💻

Ritchie Martori

💻

Akira Sudoh

💻

holmansze

💻

Josh Black

💻 📖 💡 🚇

Tayler Aitken

🎨 📖

Bethany Sonefeld

🎨

Dmitri Wolf

💻

James

💻

Kade Keith

💻

Mira Murali

💻

alisonemiller

💻

bjones526

💻

sandhya-r-reddy

💻

Alison Joseph

💻

Dogukan

💻

Erika Dsouza

💻

Jeroen Schaftenaar

💻

Joseph Meis

💻

Paul Sachs

💻

Ryan Mackey

💻

Toni

💻

shyfruan

💻

Joseph Gordon

💻

Logan McCaul

💻

Matt Chapman

💻

Scott Dickerson

💻

Darío Hereñú

💻

James Zhang

💻

Simone Riccardelli

💻

Tom

💻

Zeus Courtois

💻

Andrew Daniel

🐛 💻

Andy

🐛 💻

Nicholas Lee

💻

David Menendez

💻

Prashant Farkya

💻

Tibor Cz

📖

Xixiang Chen

💻

s100

💻

Becca Ellsworth

💻

Zack Grossbart

💻

Yohanna Gadelrab

💻 🐛 ⚠️ 📖

Carlos Eduardo Monti

💻 📖

Thomas Brown

💻