Skip to content
Monorepo that holds all of HospitalRun's v2 projects
JavaScript
Branch: master
Clone or download
fox1t Merge pull request #33 from HospitalRun/dependabot/submodules/package…
…s/frontend-0dcdf11

⬆️ Bump packages/frontend from `9528022` to `0dcdf11`
Latest commit 14b26ec Nov 20, 2019

README.md

HospitalRun logo

Last commit Activity Repo size Commitizen friendly semantic-release Gitmoji Slack Join the community on Spectrum


All HospitalRun code lives in a single repository, an architecture generally called a monorepo. This repository holds all of HospitalRun's open source projects that lived in their own separate Github repos: frontend, server and components. Built with React, Node, PouchDB/CouchDB and using offline first design, we're working to deliver an HIS system that makes usability the #1 requirement, is built specifically for developing world requirements, and seeks to give back time to patient care.

Project Development Status

Submodules Progress status Build status Coverage status
Components Status GitHub CI Coverage Status
Frontend Status GitHub CI Coverage Status
Server Status Build Status Coverage Status
Core Status N.D. N.D.
CLI Status N.D. N.D.
Docs Status N.D. N.D.

Last Update: 15 Nov 2019

Table of Contents

Toolchain & CLI

We recommend the use of nvm for the management of different versions of Node, and yarn for a fast, reliable, and secure dependency management. We suggest to install [yarn] with npm i -g yarn.

Getting Started

Use these commands to start using the monorepo. The following commands require that your GitHub account has SSH access enabled.

git clone git@github.com:HospitalRun/hospitalrun.git
cd hospitalrun
git submodule update --init --recursive
yarn
yarn workspaces run build

# Do some coding then commit with
npx git-cz

Pull all submodules

Use these commands to update all submodules and use the last available commit.

git submodule update --recursive --remote

yarn upgrade // Update all dependencies automatically
yarn update // This is similar to npm-check interactive update mode. It provides an easy way to update outdated packages.

Commiting

This repo uses conventional commits, semantic-release and gitmoji. Once you have changes staged you can run git cz from the root directory in order to commit to the proper standards.

  1. Staging all pending changes. Es: git add .
  2. Use the following command: yarn commit
  3. Updates remote refs using local refs. Es: git push

How to commit a specific package?

yarn commit-frontend
yarn commit-server
yarn commit-components
yarn commit-cli
yarn commit-core
yarn commit-docs

You must follow the following rules:

  1. Commit description must always start with a capital letter.
  2. Always use a scope. Here are some examples:

Generic

setting
ci
deps
readme
devops
system
core
testing
cli
release
lifecycle

Monorepo specific

monorepo
package
release
lifecycle
workspace

Updating the monorepo structure

Use these commands to add a new package after adding a submodule.

git submodule update --remote
git add ./packages
yarn upgrade
npx git-cz

Docker Develop Env

WIP

docker build -t hospitalrun .
docker-compose up

Behind HospitalRun

Hosted by

Sponsors

Sponsors

Backers

Backers

Lead Maintainer


Maksim Sinik

Core Team


Stefano Casasola

Michael Daly

Riccardo Gulin

Grace Lau

Jack Meyer

Matteo Vivona

Medical Supervisor


M.D. Daniele Piccolo

Contributors

Contributors

Founders


John Kleinschmidtr

Joel Worrall

Joel Glovier

License

Released under the MIT license.

You can’t perform that action at this time.