@olist/united

United is a component-based UI library for Olist's design system using React ecosystem.

Installing / Getting started

  yarn add @olist/united

It has react, react-dom, styled-components, styled-map and styled-system as peer dependencies. So, be careful whether some warning about version compatibility pops up or not after the installation.

After that you'll be able to import on you project and use the components and helpers.

  import { Text } from '@olist/united';

or

  import { Button } from '@olist/united/lib/action';
  import Link from '@olist/united/lib/action/link';

Take a look at the components documentation so that you can make the most on your job.

Developing

Built With

It was built on top of React 16.

Prerequisites

• Node version >= 8.9.0 <12.0.0.
• Npm version >= 5.5.1.
• It's fairly recommended using yarn for packages management.

Setting up Dev

Ok, you're looking forward to contributing for the united, then follow the instructions.

If you're here, you already have access to the repository, haven't you? So, just clone the project and install the dependencies.

git clone [e-mail]:olist/olist-united.git
cd olist-united/
yarn

If it's everything okay on your environment all united dependencies were installed, but if something went wrong feel free to create an issue reporting the problem.

Building

  yarn docz:dev

This starts building, watching the changes and running the server.

Release

We're automanting with release-it, but it's not working yet. For a while, you ought to change the version by hand in package.json.

Tests

  yarn test
  // or
  yarn test:watch

Lint

  yarn lint

Publishing

To publish, just run:

  make publish

It'll assure that tests were run and United was built along with its component styleguide documentation, and was deployed in Heroku.

Style guide

Take a look at docz documentation