trevor5gs / react-components

React-based UI components used in Watson demos. Builds on top of our SASS UI Components library.

Watson Developer Cloud React Components

A collection of React components to write web applications using the Watson APIs.

Documentation: https://watson-developer-cloud.github.io/react-components/

Getting Started

1. Install the library

   npm install --save watson-react-components
   

2. Add components to your React file where needed:

   Example:

   import { Header, Footer, /*...*/} from 'watson-react-components';

3. Make the assets public. For a Node.js/Express server, the following code should work:

   app.use(express.static('./node_modules/watson-react-components/dist/'));

   For other environments, copy the contents of the dist/ into your static folder.

4. Add a reference to the stylesheet.

   <link rel="stylesheet" type="text/css" href="/css/watson-react-components.min.css">

   Adjust the href as necessary if a different location was chosen in step 3

How to Contribute

1. Install Dependencies

   npm install
   

2. Start the development server

   npm run dev
   

Changes will refresh the page thanks to browsersync.

3. Run the build command before pushing merge request:

   npm run build
   

Directory structure

.
├── README.md
├── dist
│   ├── components      // ES5 react components
│   ├── css
│   ├── images
│   ├── js
│   └── scss
├── example
│   ├── build
│   ├── index.html
│   └── src
├── gh-pages
│   ├── build
│   ├── images
│   ├── index.html
│   └── src
├── gulpfile.js
├── package.json
├── src
│   ├── components      // React components
│   └── stylesheets     // Sass files
└── static              // static files
    └── images          // images

License

This sample code is licensed under Apache 2.0.

Contributing

See CONTRIBUTING.

Open Source @ IBM

Find more open source projects on the IBM Github Page