/Chiron

Primary LanguageTypeScriptApache License 2.0Apache-2.0

Foo Medical

A free and open-source healthcare webapp from the Medplum team.

Foo Medical Screenshot

What is Foo Medical?

Foo Medical is a ready to use medical practice sample app that's open source. It's meant for developers to clone, customize and run.

Features

  • Completely free and open-source
  • Secure and compliant Medplum backend, which is also open source
  • Patient registration and authentication
  • Health records
    • Lab results
    • Medications
    • Vaccines
    • Vitals
  • Patient-provider messaging
  • Care plans
  • Patient scheduling
  • All data represented in FHIR

Foo Medical is designed to be forked and customized for your business' needs. Register on foomedical.com to see it in action.

Getting Started

First, fork and clone the repo.

Next, install the app from your terminal

npm install

Then, run the app!

npm run dev

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

Log into the app on localhost using the same credentials you created on foomedical.com and you are ready to start customizing.

Deploying your app

To get started deploying your app we recommend making an account on Vercel, free accounts are available.

You can deploy this application by clicking here.

Account Setup

By default, your locally running Foo Medical app is pointing to the hosted Medplum service. Foo Medical registers signups to a test project.

To send patients to your own organization you will need to register a new Project on Medplum and configure your environment variables to point to your own project (see config.ts for an example).

If you are using the Medplum Hosted service, you can login to your Medplum Instance and add the following identifiers to your Project Site Settings

  • Google Client Id
  • Google Client Secret
  • Recaptcha Site Key
  • Recaptcha Secret Key

Contact the medplum team (support@medplum.com or Discord) with any questions.

Data Setup

When you log into Foo Medical a set of sample FHIR records is created on your behalf. The ability to run automations is part of the Medplum platform using a framework called Bots. For reference, Bot that created the records in Foo Medical can be found here.

Compliance

Medplum backend is HIPAA compliant and SOC 2 certified. Getting an account set up requires registering on medplum.com. Feel free to ask us questions in real time on our Discord Server.

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. Foo Medical uses the hosted service as a backend.