Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time



An awesome lightweight React UI Component library
Explore the docs »

View Demo · Report Bug · Request Feature

Build Status codecov contributions welcome MIT License

Table of Contents

About The Project

There are many great UI libraries for react available but almost all of them are highly customizable and full of boilerplate code, so we decided to create our own lightweight React Component library and you should give it a try.

Here's why:

  • Your time will be spent doing actual work instead of creating simple components.
  • You will not worry about consistency across your components.
  • Each component is implemented with accessibility in mind. 😄

You may also suggest changes by forking this repo and creating a pull request or opening an issue with the tag.

Built With

Getting Started

To get a local copy up and running follow these simple example steps.


  • To add quarkify library to your project
  1. Simply run one of the commands below in your project directory.
npm install quarkify@latest --save


yarn add quarkify 
  • To install storybook locally
  1. Clone the repo
git clone
  1. Install NPM packages
npm install

Or alternatively Yarn

yarn install
  1. Run tests
npm run test
yarn run test
  1. Run storybook
npm start
yarn start


To preview the live demo and see usages of the components please refer to our demo


We have several examples on our document. Here is the first one to get you started:

import Button from "quarkify/components/button"

function App() {
  return (
    <div className="App">
      <Button variant={"primary"} >Hello World</Button>

This will render Button component with primary variant:

Button Component

As you can see, to import components into your project, you need to specify the path as


Furthermore, to use Modal component:

import Button from "quarkify/components/button"
import Modal from "quarkify/components/modal";

let show = false;

function handleChange() {
  show = !show

function closeModal() {
  show = false

function App() {
  return (
    <div className="App">
      <Button onClick={handleChange}>Toggle Me</Button>
      <Modal show={show} animation={"slideInUp"}>
          Some Title
          <p>Some content</p>
          <Button onClick={closeModal} fluid>

When button is toggled, it will render the modal as it is seen below:

Modal Component

For more examples, please refer to the documentation


Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Please don't forget to check our commit message styles as we want to have consistency across our commit logs.


Distributed under the MIT License. See LICENSE for more information.