bb-clear-smart-fhir

SMART on FHIR implementation of the clear blue button health record reference

A sample SMART on FHIR app, implementing the Blue Button Health Record Format. Work in progress.

Built with Vue.js, continous deployment with GitHub Actions, automated unit tests by Jest. Hosted on GitHub Pages (needs to be launched from a SMART on FHIR sandbox, see below).

Getting started

Run the app using SMART App Launcher

• I had problems with Firefox, try using Chrome if you run into any problems.

1. Go to http://launch.smarthealthit.org/
2. Leave all settings as they are (FHIR Version R4).
3. At the bottom of the page, set the App Launch Url to: https://stfnh.github.io/bb-clear-smart-fhir/launch.html
4. Click Launch App
5. Login as practitioner
6. Select a patient
7. You will see the SMART on FHIR app populated with data from the Sandbox / Electronic Health Record system!

Local setup for development and testing

• Prerequisites: Install current versions of Node and Yarn (alternatively npm).

Get a local copy / clone repository:

$ git clone git@github.com:stfnh/bb-clear-smart-fhir.git

Install the dependencies:

$ cd bb-clear-smart-fhir
$ yarn

Serve on localhost:

$ yarn serve

This will use an open access FHIR server for testing, no OAuth2 necessary. For details see the smartClient implementation.

Create a production build and serve:

$ yarn build
$ serve -s dist/

You can now test the app using the SMART App Launcher. Use the URL to launch.html as the APP Launch URL (normally http://localhost:5000/launch.html). This app was also tested with Cerner's Code Console.