This is a Lerna project containing the core packages for the OpenMRS Frontend. These packages handle the "cross-cutting concerns" described in the Domain Decomposition document.
- openmrs
- @openmrs/esm-api
- @openmrs/esm-app-shell
- @openmrs/esm-config
- @openmrs/esm-error-handling
- @openmrs/esm-extension-manager
- @openmrs/esm-styleguide
To install and setup the repository just use the following command:
npx lerna bootstrap
For working with the app shell you don't need to have the repository cloned. You can also just use the openmrs
directly.
npx openmrs
This is a command line utility for running (or building) the app shell in isolation. In particular, it deals with everything that touches the development, distribution, and deployment of an app shell.
For building the code just run
lerna run build
Verification of the existing packages can also be done in one step using yarn
:
yarn verify
To run only the shell locally use yarn
, too:
yarn run:shell
Run yarn
to trigger Lerna's version mode. This will not create a new tag. Tags should be created on GitHub exclusively.
yarn ci:release
Important: Creating a tag on GitHub will trigger a new release.
The new architecture offers a couple of interesting possibilities. We go into them one by one.
We can now proxy any backend. For instance, using the backend of the demo instance we just run:
npx openmrs debug --backend https://demo.openmrs.org/
There are a couple of interesting public instances:
https://qa-refapp.openmrs.org/
https://demo.openmrs.org/
https://openmrs-spa.org/