...
- Install openmrs-module-spa on your OpenMRS server
- Create a directory, in which we will create a packmap package (see the following instructions). You'll probably want to make it a github repository, like this one.
- In this directory, create a package.json based on the packmap OpenMRS example
- Create an override-import-map.json file (see the example) with the line
"@openmrs/esm-root-config": "/openmrs/frontend/@openmrs/esm-root-config@1.1.1/dist/openmrs-esm-root-config.defaults.js"where 1.1.1 is the version of @openmrs/esm-root-config that you have in your package.json npm install
npm run build
- Symlink* the resultant openmrs/frontend directory into your OpenMRS server's application data directory as "frontend". For my SDK server named "foo", on Linux, I do
ln -s $(realpath openmrs/frontend) ~/openmrs/foo/frontend Start the OpenMRS server
Navigate to localhost:8080/openmrs/spa/login (assuming your server is at localhost:8080)
- If the page comes up blank...
Open the browser developer console (probably Ctrl+Shift+i)
- Work through the errors with the Troubleshooting Guide
...
Adding configuration and assets without a custom root config
If you won't be creating a custom root config, you You can configure your application in the following manner
...
Developing on modules
TODO
Using a custom root config
Once your root config is published, you can add it to the packmap package like any other module. We want to make the import map point to our module for "@openmrs/esm-root-config". Therefore we will add a line to our import map override:
"@openmrs/esm-root-config": "/openmrs/frontend/@myorg/esm-root-config@1.0.0/dist/myorg-esm-root-config.js"