User Guide

Setup: Consumer & Professional Workflow

This section explains how a professional (therapist, researcher, coach) and their client/participant should set up Oralable for collaborative monitoring.

For Professionals: Setting Up a New Participant

1. Download Oralable for Professionals from the App Store on your device
2. Sign in to create your professional account
3. Instruct your participant to download the consumer Oralable app
4. Wait for them to record sessions and share data with you
5. Import their CSV file when received
6. Review their sessions during appointments

For Consumers: Sharing Data with Your Professional

1. Download Oralable from the App Store
2. Connect your Oralable device (or use Demo Mode to practice)
3. Record sessions as directed by your professional
4. Go to Share tab and select the sessions to share
5. Tap Share CSV and send via Email, AirDrop, or Files
6. Your professional will import and review your data

Example Scenario: Speech Therapy

Sharing Methods

The consumer can share their CSV data via:

• AirDrop — Fastest for in-person handoff
• Email — Best for remote sharing
• Files app — Save to iCloud Drive, Dropbox, etc.
• Messages — Quick sharing via iMessage

1. Getting Started

Oralable monitors muscle activity using PPG (photoplethysmography) sensor technology. The app works with the Oralable Bluetooth device, or you can explore all features using Demo Mode.

First Launch

1. Download Oralable from the App Store
2. Open the app and review the welcome screens
3. Grant Bluetooth permission when prompted
4. Start exploring with Demo Mode or connect your device

2. Demo Mode

Demo Mode simulates a connected Oralable device with realistic muscle activity data. Use it to explore the app without hardware.

Enabling Demo Mode

1. Go to the Settings tab
2. Toggle Demo Mode on
3. Return to Dashboard
4. See "Demo Mode Active" banner and live data

What Works in Demo Mode

• Real-time waveform display
• Recording sessions
• Viewing history
• Sharing data as CSV

3. Connecting Your Device

Before Connecting

• Charge your Oralable device
• Enable Bluetooth on your iPhone
• Disable Demo Mode if enabled

Pairing Steps

1. Turn on your Oralable device (green LED — never red or blue)
2. Go to the Devices tab
3. Tap Scan for Devices
4. Select Oralable from the list
5. Wait for connection (streaming starts; status LED follows firmware, not a solid red/blue)
6. Return to Dashboard to see live data

Connection Status Indicators

• Green dot — Connected and streaming
• Gray dot — Not connected
• Orange dot — Demo Mode active

4. Dashboard

The Dashboard shows temple vitals (heart rate, SpO₂) and device state from your connected sensor or Demo Mode.

Dashboard readings (Phase 0)

• Heart rate / SpO₂ — temple vitals when coupling is good
• IR pulse — used for worn detect and pulse quality
• Clench / grind event labels in the patient UI come later (Phase 1+)

5. Recording Sessions

Device positioning

The app reports honest device state: on the case, on the bench, or worn. Automatic worn uses the infrared pulse, not die temperature. Seat the optical window on the temple (anterior temporalis bulge when you clench) until the app shows worn and live PPG.

Placement & recording (Vitals Phase 0)

Current pilot focus is temple / temporalis heart rate and SpO₂ with honest device state in the app. Seat the clip on the temple, connect in the Oralable app, and allow automatic recording once the device is ready. Legacy 15-second muscle-calibration flows are not required for vitals Phase 0.

1. Charge the clip in the Oralable charging case (USB-C to the case; not Qi / MagSafe)
2. Place the sensor for temple / temporalis coupling
3. Connect in the app and confirm device status (worn / battery / LED mirror)
4. Start or allow an automatic recording session

Starting a Recording

1. Ensure device is connected or Demo Mode is enabled
2. Tap Record (or wait for automatic session start when ready)
3. Confirm live PPG / vitals update in the dashboard
4. Continue normal activities or sleep as directed by your protocol

Stopping a Recording

1. Tap the Stop button
2. Recording saves automatically
3. Find it in the History tab

Recording Tips

• Record for at least 5–10 minutes to capture patterns
• Overnight bands unlock after about 1 hour worn; aim for ≥6 hours (goal 8) for a full night view. Beacon clinic nights target ≥4 hours
• Keep device properly positioned
• Note significant events for reference

Overnight state hypnogram

After a long overnight wear, the patient app can show a state hypnogram — a barcode-style view of device-inferred quiet / tonic / phasic / rescue / recovery patterns across the night. It appears on the Dashboard (morning card) and as a preview on the Share tab. This is the primary overnight graphic for personal awareness.

• Open Dashboard after an overnight session to see band chips (unlock after ≥1 h worn) plus the hypnogram
• Open Share → Clinical report section for the same hypnogram preview
• Export Clinical Temporalis PDF for the full pack (hypnogram + hourly detail + event CSV)

6. Viewing History

The History tab displays all recorded sessions.

Navigating History

1. Tap the History tab
2. Browse sessions (newest first)
3. Tap a session to view details

Session Details

• Date and time of recording
• Duration
• Interactive chart (scroll and zoom)
• Metric selector tabs

7. Sharing Data

Share recorded data as CSV or as a Clinical Temporalis PDF (hypnogram-first overnight pack). The Share tab also previews the overnight state hypnogram after a long wear night.

How to Share

1. Go to the Share tab
2. Select date range (Today, This Week, This Month, or Custom)
3. Tap Share CSV, or export Clinical Temporalis PDF for the overnight pack
4. Choose method: AirDrop, Email, Files, etc.

CSV Contents

• Timestamp per data point
• PPG values (IR, Red, Green)
• Accelerometer (X, Y, Z)
• Temperature
• Device ID

8. Settings

Coming Soon

• Subscription management
• Health Integration (Apple Health)
• Detection settings
• CloudKit sharing

9. Oralable for Professionals

Oralable for Professionals is planned after Phase 1+. It is not part of the current Beacon clinic kit. The notes below describe the intended workflow when it opens.

Getting Started

1. Download Oralable for Professionals from the App Store
2. Sign in to create your account
3. Enable Demo Mode to explore, or import participant data

Demo Mode (Professional)

Shows a sample participant with three pre-recorded sessions.

1. Go to Settings
2. Toggle Demo Mode on
3. Return to Participants to see "Demo Participant"
4. Tap to view sessions and charts

Importing Participant Data

1. Participant shares CSV from their Oralable app
2. Tap Import CSV
3. Select the file
4. Participant appears in your list
5. View and analyze their sessions

Use Cases

• Speech Therapy — Monitor jaw tension during exercises
• Research — Collect objective muscle data
• Sports — Track muscle tension patterns
• Wellness — Monitor biofeedback progress

10. Feature Roadmap

In the app today

• Temple vitals (HR / SpO₂) with device status
• Overnight state hypnogram (Dashboard + Share preview)
• Clinical Temporalis PDF export (hypnogram-first)
• CSV export

Coming Soon

• Phase 1+ muscle / IR-DC UX
• Oralable for Professionals (after share gate)
• CloudKit share codes
• Apple Health integration polish

Later

• Apple Watch companion app
• ANR M40 EMG device support (research path)

2027+

• Medical device certification pathway
• Clinical integrations