Set up Microfrontends served from OpenMRS server

If you're just getting started with OpenMRS SPA, please first set up a local development environment.

Setting up Microfrontends

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...
1. Open the browser developer console (probably Ctrl+Shift+i)
2. Work through the errors with the Troubleshooting Guide (forthcoming)

At this point, you should have microfrontends working entirely offline!

If you won't be creating a custom root config, you can configure your application in the following manner

Create a directory in your packmap package directory called "assets"
Create a config.json file in that directory
Add the command ln -s $(realpath assets) openmrs/frontend/ to the build script in package.json
Add the following line to your override-import-map.json
"config-file": "/openmrs/frontend/assets/config.json"
That config file can refer to things you put in that assets directory, which will be served under localhost:8080/openmrs/frontend/assets/

TODO

TODO