Conchs
Conchs are installable UI components: OpenMRS O3 ESMs or CDS Hooks clients that interact with elixirs and FHIR resources.
- OpenMRS ESM template: https://github.com/dermatologist/openmrs-esm-dhti-template
- CDS Hooks sandbox (for testing without an EMR): https://github.com/dermatologist/cds-hooks-sandbox/tree/dhti-1
- Standard naming
openmrs-esm-* - Communicate with elixir APIs & FHIR server
- Decouple UI experiments from EMR core
Install an OpenMRS ESM or CDS client.
npx dhti-cli conch install -g <git_url> -n <name>Flags:
-
-g, --git: GitHub repository URL. -
-n, --name: Name of the conch (required). -
-b, --branch: Branch to install from. -
-s, --sources: Additional sources/packages to include. -
-w, --workdir: Working directory.
Scaffold a new conch.
npx dhti-cli conch init -n <name>Start the frontend development server.
npx dhti-cli conch start -n <name>See Hot Reload for the dev sync command to copy the built dist into a running container.
npx dhti-cli docker -n yourdockerhandle/conch-test:1.0 -t conch
Use the CDS Hooks sandbox to simulate order-select flows and test summarization or Q&A workflows.
- OpenMRS O3: https://o3-docs.openmrs.org/
- CDS Hooks: https://cds-hooks.org/