Skip to content

MetroStar/comet

Repository files navigation

Comet Component Library


Comet is a React with TypeScript Component Library based on USWDS.

In the beginning, Comet was built with a primary focus of USWDS. Today however, it has become more of a framework for React Apps which require USWDS, as well as other functionality (charts, custom components, etc). In the end, we hope to provide a set of modular tools to accelerate developer productivity and simplify the use of Design Systems, particularly USWDS.

Table of Contents

  1. Overview
  2. Getting Started
  3. Running the Project Locally
  4. Want to help?

Overview

Comet consists of multiple packages, each providing specific functionality. These packages can be used independently or all together, depending on your use case. See below for more details on each package:

  • comet-uswds - The base USWDS component library implemented in React with TypeScript.
  • comet-data-viz - A set of Victory Chart components provided as a Comet wrapper.
  • comet-extras - A set of custom components, intended to fill in the gaps where USWDS does not provide an implementation.
  • comet-cli - A CLI for creating Comet Apps.

Getting Started

In order to simplify the process of getting started, we have provided a starter app which includes our components. This app also provides some additional opinionated tools to further accelerate the process of getting started. These additions are not required. The starter app repo can be found here: Comet Starter App.

See each package directory for additional information on getting started.

Running the Project Locally

  1. To install dependencies, run the following:
npm install
  1. To start storybook, run the following:
npm run storybook

Want to help?

Interested in contributing to any of the packages in this project? Review our contributing info here: Contributing.