Build a Medication Reminder App with Ovok in 30 Minutes

A hands-on Expo and React Native tutorial for medication plans, local reminders, patient-reported adherence, and offline behavior with Ovok.

Build a patient-facing medication reminder app in ten steps with Expo, React Native, @ovok/native, @ovok/core, and FHIR R4. The finished tutorial app signs a patient in, reads the patient's medication plan, shows today's scheduled doses, schedules private local reminders, records patient-reported taken or skipped events, and shows history.

The title is a target for an experienced developer who already has an Ovok sandbox project. Native builds, Console configuration, clinical review, and device-specific testing can take longer.

What you will build

  • A patient app that reads active MedicationRequest resources for the authenticated Patient.
  • A Today screen that displays only schedule details explicitly represented in the request.
  • Local notifications scheduled by the mobile app with Expo Notifications. Ovok does not schedule these device reminders.
  • MedicationAdministration resources for occurrence-level patient reports. “Missed” is calculated by the app and is not written as a clinical administration event.
  • A paginated adherence history and an encrypted local cache/outbox for offline use.
  • Localised interface text loaded from the project's Ovok CMS translations, not bundled translation JSON files.

The sandbox CapabilityStatement currently advertises read, create, update, delete, history, and search interactions for Medication, MedicationRequest, MedicationStatement, MedicationAdministration, and MedicationDispense. Capabilities and project permissions can differ by environment; check your own /fhir/R4/metadata CapabilityStatement before relying on an interaction.

Before you start

  • An Ovok sandbox project and a synthetic patient account.
  • A development machine with Node.js, Xcode for iOS builds, and/or Android Studio for Android builds.
  • Familiarity with React Native, TypeScript, and Expo Router.
  • A project owner or administrator who can configure the sandbox AccessPolicy and project features.

This is a software implementation tutorial, not prescribing guidance. Use synthetic records only. Do not create, change, or discontinue a real medication plan from this patient app. The application displays instructions supplied by the plan and does not advise whether or how to take a medicine.

Tutorial map

  1. Create the React Native app
  2. Create and configure the Ovok project
  3. Model the medication plan
  4. Set up localisation and time handling
  5. Initialise Ovok and authentication
  6. Build the Today screen
  7. Add medication reminders
  8. Record medication adherence
  9. Build History and Medication Details
  10. Offline behavior, Settings, and localisation

FHIR model at a glance

MedicationRequest is the plan or order, including the medication, Patient reference, status, and dosage instructions. Medication can hold a separately reusable medication definition, but a request can also carry a medicationCodeableConcept; this tutorial uses a text-only synthetic concept to keep the example small. MedicationStatement records a statement about medication use over a period. For this tutorial's individual reminder occurrences, the app creates a MedicationAdministration with completed or not-done status and identifies the Patient as the reporter/performer. That record is a patient report, not independent verification.

There is no Ovok medication-plan hook, reminder scheduler, or generic offline FHIR write queue in the SDK. The app uses the current FHIR client methods for resources, Expo Notifications for local device reminders, and its own SQLCipher-backed cache/outbox for this example. The SDK's built-in offline queue is for measurements; it does not queue medication resources.

Expected result

At the end, the app displays the sandbox patient's active medication schedule, can deliver already-scheduled reminders without network access, records taken/skipped reports to Ovok when online, and keeps pending reports in an encrypted local outbox until they can sync. The app never recommends a dose or tells a patient how to compensate for a missed dose.

Reference documentation

Next step

Start with step 1: create the React Native app.

Last updated on

On this page