Rebul

React UI Component Library built with the Bulma CSS Framework

Installation

npm install rebul bulma

Basic usage

Rebul does not depend on Bulma's stylesheets as we don't want to restrict you to any one version, hence you will have to import it yourself.

import 'bulma/css/bulma.css';
 
import Button from 'rebul/lib/Button'; // or: import { Button } from 'rebul';
 
export default () => <Button color="primary">Hello world</Button>

Documentation

Go to the docs

Developing

You can easily develop Rebul components locally by running a local instance of our docs:

git clone https://github.com/jxom/rebul.git
cd rebul
npm install
npm run catalog-start

then navigate to http://localhost:4000

Contributing

Contributing to Rebul is easy! With four simple steps:

Create a branch

1. Fork the repository
2. git clone <your-repo-url> to clone your GitHub repo to your local one
3. git pull origin master to pull the latest code
4. npm install to install the project's dependencies
5. git checkout -b the-name-of-my-branch to create a branch (use something short and comprehensible, such as: added-button-component).

Make the change

Note: You can run npm run catalog-start, and then navigate to http://localhost:4000/ to interactively develop your changes.

Push the change!

1. git add -A && git commit -m "My message (#issue-number/pr-number)" (replacing My message (#issue-number/pr-number) with a commit message, such as Added button component (#43)) to stage and commit your changes
2. git push my-fork-name the-name-of-my-branch

License

MIT © Jake Moxey