Medplum Patient Intake Demo

A starter application for building a patient intake app on Medplum.

This example app demonstrates the following:

• How to build a patient intake form on Medplum collecting demographics, coverage, Social Determinants of Health, languages and consent information.
• Converting the form data into structured data (Patient, Coverage, Observation) for easy retrieval and longitudinal tracking.
• Implementing conditional flows in questionnaires.
• Using Medplum React Components to build a patient intake form.

Code Organization

This repo is organized into two main directories: src and data.

The src directory contains the React app that implements the intake form UX. In addition, it contains a bots directory, which has Medplum Bots to implement the parsing of the questionnaire response into structured data.

The data directory contains data that can be uploaded for use in the demo. The example directory contains data that is meant to be used for testing and learning, while the core directory contains resources, terminologies, and more that are necessary to use the demo.

UI and components

• Patients page listing all the patients in the system
• Patients chart page page with 3 panels:
  • Clinical Chart
  • Details (including SDOH and Consents)
  • Actions (with a button to fill in the intake form)
• Patient intake form page to fill in the intake questionnaire
• Intake form customization page where it's possible to edit fields of the intake form.

Getting Started

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 to your local machine.

Next, install the dependencies.

npm install

Then, build the bots

Warning

Bots are not on by default for Medplum projects, make sure they are enabled before proceeding.

npm run build:bots

Then, run the app

npm run dev

This app should run on http://localhost:3000/

Uploading sample data

Click Upload Core data in the app navigation menu and then click the upload button. Click Upload Example Bots in the app navigation menu and then click the upload button. [Optional] Click Upload Example data in the app navigation menu and then click the upload button.

About Medplum

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