react-gears

react-gears is a React implementation of Appfolio UI components, using React, Bootstrap 4, and reactstrap.

https://appfolio.github.io/react-gears

---

Getting Started

npm install @appfolio/react-gears

Example

import React from 'react';
import { Button } from '@appfolio/react-gears';

export default (props) => {
  return (
    <Button color="danger">Danger!</Button>
  );
};

Development

IMPORTANT: Make sure your commits follow conventional commits guidelines!

Install dependencies:

npm install

Run storybook examples:

npm start

Open http://localhost:6006 in browser

Run tests & coverage report:

npm test

• Runs unit tests using Mocha and enzyme

If using Cypress for integration testing, you can use react-gears-cypress for testing react-gears components.

Run Linter

npm run lint

• Runs ESLint using appfolio-react as the base configuration

Publishing

Release PRs are automatcally generated by release-please when new commits are merged to master. When you're ready to publish, just merge the release PR (branch should look like release-v${major}.${minor}.${patch}), pull master, and run npm publish.

Publishing pre-releases

Open a PR and a comment will be added to the PR notifying a pre-release was created after a few minutes.