A starter application for building a health record system on Medplum.
This example app demonstrates the following:
- Using Medplum React Components to display a chart that provides visibility on a patient
- More information on a charting experience
- Using Medplum GraphQL queries to fetch linked resources
The application will feature the following core workflows:
- Visit documentation
- Task creation and assignment
- Appointment scheduling
- Patient registration/onboarding
- Lab orders
- Ordering medications
- Claim creation and billing
- Patient/Provider Messaging
If you haven't already done so, follow the instructions in this tutorial to register a Medplum project to store your data.
Fork and clone the repo. Alternatively, this app lives in the Medplum monorepo at examples/medplum-provider — if you are working from the monorepo, run npm ci and npm run build at the repo root first so the workspace packages are built.
Next, install the dependencies.
npm installThen, run the app
npm run devThis app should run on http://localhost:3001/
By default, the app connects to the hosted Medplum service at https://api.medplum.com/.
To run against a Medplum server on your own machine, follow the Run the stack guide to start the API server on port 8103, then edit .env in this directory:
MEDPLUM_BASE_URL=http://localhost:8103/
Restart npm run dev after changing .env.
Some fields in this app (diagnoses, medications, race/ethnicity, and others) autocomplete against clinical terminologies such as ICD-10, RxNorm, and US Core / VSAC value sets. On hosted Medplum, these are provided by shared projects linked into your project. A fresh self-hosted or local server includes only the base FHIR R4 terminology, so these fields will show a "ValueSet not found" message inline and you will need to enter codes manually. To enable them, upload the value sets and import their code systems into a shared project (see CodeSystem/$import) and link that project, or contact Medplum for access to the hosted terminology.
Medplum is an open-source, API-first EHR. Medplum makes it easy to build healthcare apps quickly with less code.
Medplum supports self-hosting and provides a hosted service. Medplum Hello World uses the hosted service as a backend.
- Read our documentation
- Browse our react component library
- Join our Discord