OpenMRS 3.x & iSantePlus: A Tutorial

Creating an OpenMRS 3.x distribution for iSantePlus

In this tutorial, we will:

• build a 3.x distribution from scratch
• add some basic modules to the distribution
• run the distribution as a standalone application
• connect with a running iSantePlus instance

Useful Links

https://wiki.openmrs.org/display/projects/3.x+Implementer+Documentation#id-3.xImplementerDocumentation-ExampleDistribution

http://o3-dev.docs.openmrs.org/#/main/distribution

Instructions

Create a folder for the repository

mkdir iSantePlus3x
cd iSantePlus3x

Build App Shell

This command uses the openmrs Node.js package that can be found here: https://www.npmjs.com/package/openmrs (published package) and https://github.com/openmrs/openmrs-esm-core/tree/master/packages/tooling/openmrs (code)

npx openmrs build --config-path ./config.json 

Create an Import Map using Interactive Tool

npx openmrs assemble --config ./build-config.json --mode config  

Create an empty Config File

config.json

{}

Boot up iSantePlus

docker-compose up -d