Walkthrough: Provider-Facing App
Introduction
This section will help you build a provider facing linked application with MeldRx. This example will be linked with Epic, however you can choose a different EHR.
Prerequisites
Before getting started, please make sure you have the following:
- An account with Epic FHIR developer portal
- A MeldRx Developer account (sign up at MeldRx)
- Dowload or update the create-meldrx-app CLI
MeldRx App Setup
Log in to MeldRx and navigate to the apps page (MeldRx > Apps
) and press Register App
.
Step 1
Provide app details
- Give your app a Name.
- Select
Provider
on theApp User Type
. - Set the
Client Type
toPublic
. - For the
Scopes
select the following:
patient/*.read openid profile launch launch/patient
- Set the
Redirect Urls
as :http://localhost:3000/login-callback
http://localhost:3000
- Go to the Next step.
Step 2
Connect linked apps
- Select a
Add Linked App
. - Choose
Epic
as the Linked App Provider. - Choose to use your own credentials.
- Give your linked app a name.
- In the
Client Id
paste in theNon-Production Client ID
from the your Epic app. - Match the
Scopes
with the scopes from your app above:
patient/*.read openid profile launch launch/patient
- Add the Linked App.
Step 3
Provide workspace details
- Select
Yes
to workspace creation. - Give your Workspace a name.
- Select the same
FHIR API Provider
as you did in the Linked app e.g.Epic
, if not already selected. - Select the
Epic Sandbox
url from the dropdown. - Once the validation is complete press
Create
.
You should see a screen like this upon creation:
You can follow the steps on this page to create your MeldRx app.
Here you can find the commands you need to run to bootstrap your application using the create-meldrx-app CLI.
Creating the app
Now that you've set up an app and workspace that are linked with Epic, you can move on to coding the app. We will be using the Create-MeldRx-App CLI to get a quick template for a provider facing app.
Installation
npm i -g create-meldrx-app
Using the Tool
Navigate to the path where you want to create your application and run:
npx create-meldrx-app --meldrx-app-id [clientId] --workspace-url [workspaceUrl]
- Supply the directory where you want to create your app.
- Select the
Clinician
option. - Select the
Web
option. - Select
Patient Viewer Web App (NextJS)
.
Now change your directory to your newly created app folder and run:
npm install
You can now run the application by using:
npm run dev
Testing your app
- Once your app is running, in your browser go to
http://localhost:3000/
. - You should see a template screen, here press the
Launch with MeldRx
button. - On the Epic MyChart screen login as an EHR(username:
FHIR
/ password:EpicFhir11!
). You can find the details for other EHRs here. - For the
Department
keep the default value ofEMC FAMILY MEDICINE
and press continue. - Search for one of the test patients (i.e.
Theodore Mychart
), select them and pressAccept
. - Grant access for that patient to your app.
- On the MeldRx consent press
Allow Access
. - You should see on a
Patient Sphere
page with the details of the patient that you selected.