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

yarn add @appfolio/react-gears
# or for npm:
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:

yarn install

Run storybook examples:

yarn start

Open http://localhost:6006 in browser

Run tests & coverage report:

yarn 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

yarn lint

• Runs ESLint using appfolio-react as the base configuration

Publishing

Release PRs are automatically 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}).

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.