Skip to content
Frontend for HospitalRun
TypeScript Other
Branch: master
Clone or download


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github ci(yarn): remove yarn job May 23, 2020
.vscode build(release): removes semantic release and fix husky precommit Feb 7, 2020
docs docs(mkdos): updates theme Feb 8, 2020
public feat(pwa): adds pwa support Jan 11, 2020
src feat(incidents): filter incidents (#2087) May 20, 2020
.dockerignore build(docker): improves dockerfile and updates dockerignore Feb 14, 2020
.editorconfig chore(github): adds lint and azure ci toolchain Oct 15, 2019
.env.example feat(patients): set max date in date of birth date picker (#2002) Apr 21, 2020
.eslintrc.js refactor: 💡 Set `no-unresolved` rule to off again May 14, 2020
.gitignore feat(labs): ability to filter by status on labs screen (#2033) May 6, 2020
.gitpod.yml ci(gitpod): enhance gitpod setup. Apr 25, 2020
.npmrc 🐛 (dep) Uses ~ for all deps Sep 27, 2019
.nvmrc chroe(nvm): adds nvmrc Dec 18, 2019
.prettierrc fix(prettier): changes endofline option Feb 15, 2020
.replit Add run on badge to README Dec 11, 2019 chore(release): 2.0.0-alpha.3 May 2, 2020
Dockerfile build(docker): updates install method removing c option on npm i command Feb 15, 2020
LICENSE Adds new MIT license Aug 6, 2019 docs: ✏️ Updates Core Team member Github link Apr 27, 2020
azure.yaml build(azure): fixes docker stage Feb 15, 2020
commitlint.config.js ci(commit): removes gitmoji and adds commitizen plugins Sep 27, 2019
jest.config.js test(eslintrc): remove createDefaultProgram and update jest config Mar 6, 2020
mkdocs.yml Update mkdocs.yml Feb 8, 2020
nginx.conf build(docker): improves dockerfile and updates dockerignore Feb 14, 2020
package.json chore(deps): bump date-fns from 2.13.0 to 2.14.0 (#2089) May 24, 2020
tsconfig.json refactor: 💡 Disallow absolute paths for internal modules May 14, 2020

HospitalRun Frontend

Status Release Version GitHub CI Coverage Status Language grade: JavaScript Documentation Status FOSSA Status Commitizen friendly dependabot Slack Run on Gitpod Ready-to-Code

React frontend for HospitalRun: free software for developing world hospitals.

Version 1.0.0-beta is no longer supported. Version 2 is currently under development.

  • To contribute, follow the guidelines in the readme or alternatively ask for details on Slack channel #contributors.
  • To use version 1.0.0-beta (not production ready) in a hospital facility, ask for support on Slack channel #troubleshooting.



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 hospitalrun-frontend
  3. Install the dependencies: yarn
  4. Run yarn run start to build and watch for code changes

Online one-click setup for contributing

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

Open in Gitpod

Connecting to HospitalRun Server

Note: The following instructions are for connecting to HospitalRun Server during development and are not intended to be for production use. For production deployments, see the deployment instructions.

  1. Configure HospitalRun Server
  2. Start the HospitalRun Development Server
  3. Copy the .env.example file to .env
  4. Change the REACT_APP_HOSPITALRUN_API variable to point to the HospitalRun Development Server.

Potential Setup Issues

Some developers have reported the following errors and the corresponding fixes

Problem with Project Dependency Tree

There might be a problem with the project dependency tree.
It is likely not a bug in Create React App, but something you need to fix locally.
The react-scripts package provided by Create React App requires a dependency:
  "babel-loader": "8.1.0"
Don't try to install it manually: your package manager does it automatically.
However, a different version of babel-loader was detected higher up in the tree:
  /path/to/hospitalrun/node_modules/babel-loader (version: 8.0.6)
Manually installing incompatible versions is known to cause hard-to-debug issues.
If you would prefer to ignore this check, add SKIP_PREFLIGHT_CHECK=true to an .env file in your project.
That will permanently disable this message but you might encounter other issues.
To fix the dependency tree, try following the steps below in the exact order:
  1. Delete package-lock.json (not package.json!) and/or yarn.lock in your project folder.
  2. Delete node_modules in your project folder.
  3. Remove "babel-loader" from dependencies and/or devDependencies in the package.json file in your project folder.
  4. Run npm install or yarn, depending on the package manager you use.

To fix this issue, add SKIP_PREFLIGHT_CHECK=true to the .env file.

Running Tests and Linter

yarn test:ci will run the entire test suite

yarn test will run the test suite in watch mode

yarn lint will run the linter

yarn lint:fix will run the linter and fix fixable errors

Useful Developer Tools

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 mandatory for making proper commits. Once you have staged your changes, can run npm run commit or yarn commit from the root directory in order to commit following our standards.

Behind HospitalRun

Hosted by



Big Thanks

Cross-browser Testing Platform and Open Source <3 Provided by Sauce Labs



Lead Maintainer

Maksim Sinik

Core Team

Stefano Casasola

Michael Daly

Riccardo Gulin

Grace Lau

Jack Meyer

Matteo Vivona

Medical Supervisor

M.D. Daniele Piccolo




John Kleinschmidtr

Joel Worrall

Joel Glovier


Released under the MIT license.

You can’t perform that action at this time.