Skip to content

dexma/ui-components

Repository files navigation

Dexma

Dexma UI Components

React components library by Dexma


Travis CI badge npm version badge

Table of contents

Usage

  1. Install with npm: npm install --save @dexma/ui-components

  2. Use the component importing from the library

import { Button } from "@dexma/ui-components";
<Button text="Some text" variant="primary" size="medium"/>
  1. Optional: You can set the Theme with your personal variables, we provide the Theme component and you only need to set the options:
import { Theme, Button } from "@dexma/ui-components";
<Theme options={{
    primary: "#aa0800"
}}>
    <Button text="Some text" variant="primary" size="medium"/>
</Theme>

You can find all the configuration in the theme file theme.js

Installation

To run the installation locally on your machine, you need Node.js installed on your computer.

git clone https://github.com/dexma/ui-components
cd ui-components
npm install

Documentation

For the documentation we use storybook docs that transforms our stories into world-class component documentation.

  • Run storybook: npm run storybook
  • If you need to export static doc run npm run build-storybook this will export a static folder with all our component docs

Changelog

For changelogs, check out the CHANGELOG section of ui-components

Testing

We use React Testing Library as our testing lib you can check out the documentation

  • To run our test: npm run test

Contributing

Check out the CONTRIBUTING document in the root of the repository to learn how you can contribute.