Skip to content
This repository has been archived by the owner on Jan 9, 2023. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


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

HospitalRun Components

NPM Version GitHub CI Coverage Status Language grade: JavaScript Bundlephobia Code scanning FOSSA Status dependabot Commitizen friendly semantic-release Netlify Status Slack

This repository will host reusable react components made for the HospitalRun frontend. It's a place for designers and developers alike to collaborate quickly. This library makes up the text inputs, labels, etc of HospitalRun Frontend.


Install components:

npm install @hospitalrun/components

Install react-bootstrap:

npm install react-bootstrap

[Optional] You may need node-sass if you want to import components' .scss files:

npm install node-sass --save-dev


Contributions are always welcome. Before contributing please read our contributor guide.

  1. Fork this repository to your own GitHub account and then clone it to your local device
  2. Navigate to the cloned folder: cd components
  3. Install the dependencies: npm install
  4. Run npm run dev to build and watch for code changes
  5. In another window, run storybook npm run storybook. Story book should open in a your default browser at http://localhost:6006.
  6. You will be able to test components with storybook and enjoy live reloading!

Online one-click setup for contributing

Contribute to HospitalRun using GitHub Codespace a fully featured online development environment that will automatically: clone the repo, install the dependencies and start the webserver.

Working on an Issue

In order to optimize the workflow and to prevent multiple contributors working on the same issue without interactions, a contributor must ask to be assigned to an issue by one of the core team members: it's enough to ask it inside the specific issue.

How to commit

This repo uses Conventional Commits. Commitizen is recommended for development. Once you have changes staged you can run git cz from the root directory in order to commit to the proper standards.

Alternatively, if you are using NPM 5.2+ you can use npx instead of installing globally: npx git-cz


Released under the MIT license.