# Build a Whole-Person Healthspan & Coaching App with Ovok

Canonical page: https://docs.ovok.com/guides/whole-person-wellness

Build a small but real React Native app where a member can sign in, record weekly reflections across five areas of wellbeing, review supported health-platform data, set personal goals and share progress with a coach.

This is an implementation tutorial. Each step extends the same Expo project and links to Ovok's canonical references when a platform detail deserves its own page.

> **Time estimate:** 30 minutes for the FHIR and app structure, plus the time needed to configure a sandbox project, build native binaries and test HealthKit / Health Connect on a device. Native permission setup and coach-sharing configuration are not a 30-minute shortcut.

## What you will build [#what-you-will-build]

The app keeps three kinds of information distinct:

| Information | Example | Stored as |
| --- | --- | --- |
| Imported measurement | Sleep sessions, local-day step totals and resting heart-rate samples, when permission and data are available | FHIR Observation |
| Member reflection | Perceived sleep quality, movement, nutrition, stress and recovery | FHIR QuestionnaireResponse |
| Coaching relationship and intent | Coach assignment and a member-chosen goal | FHIR Practitioner / PractitionerRole / CareTeam and Goal, where enabled |

The React Native SDK imports sleep and step records using their HealthKit or Health Connect source coding systems; these mappings are not LOINC codes. Step totals use a local-calendar-day boundary. A sleep session is an elapsed interval and may include awake time, so this tutorial does not label its duration as time asleep. Resting heart rate uses its reviewed LOINC mapping.

## Architecture [#architecture]

~~~mermaid
flowchart LR
  member[Member] --> app[Expo app]
health[Apple Health / Health Connect] -->|sleep sessions, step totals, resting heart rate| sync[Ovok Native data sync]
  sync --> obs[FHIR Observation]
  app --> reflection[FHIR Questionnaire]
  reflection --> response[FHIR QuestionnaireResponse]
  app --> goal[FHIR Goal]
  member -->|explicit record share| coach[Human coach]
  coach -->|server-authorized reads| ovok[Ovok FHIR APIs]
  obs --> ovok
  response --> ovok
  goal --> ovok
~~~

## The five areas [#the-five-areas]

- **Sleep:** display imported sleep-session intervals separately from the member's perceived sleep quality reflection. An interval is not necessarily time asleep.
- **Movement:** display imported local-day step totals separately from movement reflections and personal goals.
- **Nutrition:** a short reflection, not a dietary assessment or prescription.
- **Stress:** a self-report, not a physiological measurement or psychological assessment.
- **Recovery:** a self-report. The app does not derive readiness or recovery scores from heart rate.

The dashboard labels imported measurements and reflections separately. It does not combine them into a healthspan score.

## Before you start [#before-you-start]

- An Ovok sandbox project and a patient tenant code.
- Access to the Ovok Console to configure registration and AccessPolicies.
- A Mac with Xcode for the iOS HealthKit build, or an Android device/emulator that supports Health Connect.
- A real device for validating HealthKit / Health Connect permissions and data availability.
- A separate sandbox project for this coaching tutorial. The current patient-to-practitioner sharing flow shares a patient's **whole record**. Do not place unrelated or production records in this tutorial project.
- Synthetic accounts and reflections only.

## Tutorial steps [#tutorial-steps]

1. [Create the React Native app](/guides/whole-person-wellness/create-the-react-native-app)
2. [Create and configure the Ovok project](/guides/whole-person-wellness/create-and-configure-the-ovok-project)
3. [Build onboarding, authentication and profile](/guides/whole-person-wellness/build-onboarding-authentication-and-profile)
4. [Connect Apple Health and Health Connect](/guides/whole-person-wellness/connect-apple-health-and-health-connect)
5. [Build the five-domain wellness model](/guides/whole-person-wellness/build-the-five-domain-wellness-model)
6. [Build the weekly wellness reflection](/guides/whole-person-wellness/build-weekly-wellness-reflection)
7. [Build the healthspan dashboard and trends](/guides/whole-person-wellness/build-the-healthspan-dashboard-and-trends)
8. [Add the coach relationship](/guides/whole-person-wellness/add-the-coach-relationship)
9. [Add goals and progress reviews](/guides/whole-person-wellness/add-goals-and-progress-reviews)
10. [Finish history, settings, localisation and validation](/guides/whole-person-wellness/finish-history-settings-localisation-and-validation)

## Product boundary [#product-boundary]

This is a wellness and coaching example. It does not diagnose, predict disease, prescribe treatment, calculate biological age, or claim to increase lifespan or prevent disease. Trends are descriptive; a coach and member can discuss them together. A CareTeam records a relationship but does not grant data access. The server-side AccessPolicy and sharing workflow remain the authorization boundary.

## What this tutorial deliberately does not fake [#what-this-tutorial-deliberately-does-not-fake]

- No LOINC claim for sleep or step records; their source coding systems remain visible.
- No derived readiness, recovery or healthspan score.
- No health-data access implied by placing two resources in a CareTeam.
- No fine-grained wellness-only sharing claim: the documented patient-to-practitioner share covers the whole record in the project.
- No clinical advice, coaching credential claims or promises about health outcomes.

## Continue [#continue]

Start with [Step 1: Create the React Native app](/guides/whole-person-wellness/create-the-react-native-app).
