Skip to content
/ fhir-app-starter Public template

🔥 Open Source FHIR App project starter. Start building your app right away.

License

Notifications You must be signed in to change notification settings

bluehalo/fhir-app-starter

Repository files navigation

Logo

Travis

FHIR App Starter

Start building your next FHIR App in seconds. Develop it with modern technologies and a stellar developer experience.

Features

React --

  • React first. Build an App in a framework that is future-proof and performant.

Redux --

  • Redux has proven to be the leader in client state management. Use it to store your FHIR documents.

Redux-Saga --

  • Redux Saga is a great way to make asynchronous calls to FHIR servers.

Semantic-UI --

  • Perhaps the most opinionated decision, Semantic-UI is an excellent CSS Framework and component library for building applications.

Production Ready --

  • This project has a scalable component structure utilizing a Container pattern that is ready for Production out of the box.

Deploy Now

Deploy to Netlify

Getting Started

Launch from Cerner's Sandbox

  1. Create an account on Cerner's Code Sandbox and log in.

  2. Create an application by clicking New App

    NewApp

    If you are just developing locally, use the following:

Config Example value
App Name Anything you want
SMART Launch URI http://localhost:3000/launch.html
Redirect URI http://localhost:3000/
App Type Provider
FHIR Spec DSTU2
Authorized Yes
Patient Scopes Patient.read Observation.read Condition.read
User Scopes Not needed unless your requirements need this
  1. Clone fhir-app-starter

    git clone https://github.com/asymmetrik/fhir-app-starter
    cd fhir-app-starter
  2. Update your app config

    The app builds the information into the application automatically. All you need to do is update your config.js.

    // Update me!
    module.exports = {
      clientId: '', // Your clientId
      scope: '', // "patient/Patient.read patient/Observation.read" or: Whatever scopes you like
      iss: '', // Your FHIR Server or: Found on Cerner's Sandbox under "FHIR Spec: dstu2 - " <iss listed here> "
      redirectUri: '', // Your redirectUri
    };
  3. Install and start

    yarn install
    yarn start

    You should see your browser open up your app.

    Unconnected

    Notice the "Unconnected..." banner. This is because we have not launched from an EHR yet. Cerner's Code Sandbox allows us to launch the application in this exact way. Let's do that.

  4. Launch from Cerner's Code Sandbox

    On Cerner's Code Sandbox, click into your application. Select Begin Testing. Select a Patient, and Select Launch. After launching you may be redirected to a login page. Use username portal and password portal. If you configured things correctly, you should see that your application has been launched properly.

    Success

Building for production

Build for production using the following command:

yarn build

Your app will be located in the build directory

Inspiration

  • react-boilerplate
  • react-redux-saga-boilerplate
  • create-react-app