OdinEye

Personal Health Intelligence — On-Device. Private. Precise.

OdinEye is a centralized personal health hub for Android. It aggregates live biometrics from multiple wearables and Android Health Connect, tracks your medication routine with real-time reminders, analyzes muscle recovery and body composition, and delivers on-device AI coaching — all without sending your health data to the cloud.

• On-Device Voice Pipeline (OdinEyeVoiceModule): Hands-free speech interaction utilizing Android's native SpeechRecognizer and TextToSpeech (TTS) — 100% offline, zero cloud transmission.
• Interactive Transcribe Card: Real-time streaming voice transcription into an editable TextInput, allowing hands-free speaking, tap-to-correct editing, manual typing, or 1-tap suggested query selection.
• Audio Equalizer & Native Animations: 5-bar live equalizer animating dynamically with 100% Native Driver (useNativeDriver: true) without JS bridge overhead.
• Audio Read-Aloud: Optional toggle to speak AI responses out loud automatically using on-device neural TTS.
• Dual-Mode Compatibility: Runs full offline native speech in compiled Android builds (npm run android), and seamlessly supports mobile keyboard dictation (Google / Samsung Voice Typing) in Expo Go.

• De-Fatigue Composite Routine: Analyzes real-time fatigue scores across 10 muscle groups (Quads, Hamstrings, Chest, Lats/Back, Shoulders, Calves, Glutes, Forearms, Abs, Lower Back) and dynamically sequences targeted restorative stretches.
• Full-Screen Circular Timer: Visual phase countdown ring with intelligent intervals (Prepare 5s → Stretch 30–45s → Switch Side 5s → Next Exercise).
• Tactile Transitions & Ambient Delta Waves: Gentle haptic pulses on phase changes and integrated 2Hz Delta restorative frequency soundscapes.
• Omnipresent Access: Launch from the top banner in Body Analysis, individual muscle group dossier cards, or directly via one-tap action pills in AI Coach recommendations.

• 7-Day Cumulative Sleep Debt: Computes personal sleep debt against your biological baseline (default 8.0h/night) with a strict zero-dummy data guarantee (calculated solely against recorded nights).
• Physical vs. Cognitive Restoration:
  • Physical Restoration (Deep Sleep): Tracks slow-wave delta sleep against the clinical 15%–25% target for cellular turnover and human growth hormone release.
  • Cognitive Resilience (REM Sleep): Tracks paradoxical REM sleep against the clinical 20%–25% target for emotional memory consolidation and synaptic pruning.
• Scandinavian Bento Card: Full-width spacious bento layout with target range indicator brackets, status badges (Optimal, Sub-optimal, Abundant), and somatic bedtime coaching advice.

• Somatic Eyes-Closed Meditation: Inhale (rising double micro-pulse), Hold (subtle anchor tap), and Exhale (smooth soothing release) vibration cues so you can meditate with closed eyes.
• In-Chamber Toggle: Instant 📳 Haptics: ON / OFF toggle pill in the full-screen breathing chamber header with persistent storage.
• Crisp Navigation Haptics: Responsive micro-vibrations (28ms) on bottom tab bar presses (FloatingTabBar) and programmatic in-app card jump links.

• Pill Reminder 4×2 Widget: Displays the next scheduled dose with a direct "Take" action button right on the Android home screen without opening the app, updating live adherence.
• Zen Streak & Vitals 4×2 Widget: Displays daily steps with progress bar, real-time/resting heart rate, current mindfulness streak, and a one-tap "Breathe" launcher.
• Widget Hub in Settings: Live visual preview, step-by-step setup guide, and manual instant sync.

• Background Sound Engine (OdinAudioEngine): Real-time mathematical sound synthesis running on a dedicated thread via native Android AudioTrack (44.1 kHz 16-bit stereo PCM) that plays continuously with the screen dimmed.
• 14 Bespoke Soundscapes:
  • Binaural Beats: 40Hz Gamma (focus), 10Hz Alpha (flow), 6Hz Theta (meditation), 2Hz Delta (restoration).
  • Solfeggio Frequencies: 432Hz Harmonic Peace, 528Hz Cellular Transformation, 639Hz Compassion.
  • Colored Noise: Velvet Brown Noise (1/f² Brownian walk), Organic Pink Noise, Tranquil White Noise.
  • Procedural Nature: Resonant ocean waves with LFO modulation, gentle rain, forest breeze, chirping birds.

• Morphing vector SVG face (MoodFaceIcon) across 5 emotional states (Unhappy, Sad, Normal, Good, Happy) paired with reactive pastel concentric ripple auras, spring bounce physics, and persistent daily state.

# 1. Install dependencies
npm install

# 2. Start Metro bundler
npm start

# 3. Run on Android (USB + ADB)
npx expo run:android

No API keys are required to start. The app runs with local data immediately. Connect your wearables via the Config tab when ready.

All wearable tokens and API keys are stored in an on-device AES-256-CBC encrypted vault — never in plaintext, never sent to the cloud.

centralized-health-app/
├── App.tsx                          # Entry point — onboarding gate
├── index.ts                         # Expo bootstrap
├── babel.config.js                  # Babel AST transform cache config
├── metro.config.js                  # Metro bundler config with crawler exclusions
├── app.json                         # Expo + Android manifest config
├── eas.json                         # EAS build profiles
├── LICENSE
├── assets/                          # Brand assets & launcher icons
│   ├── OdinEye-Logo.svg             # Master vector logo (Fabric.js SVG)
│   ├── OdinEye-Logo.png             # Master raster logo (1280x1340 RGBA)
│   ├── icon.png                     # Primary application icon (1024x1024)
│   └── adaptive-icon.png            # Android adaptive foreground (1024x1024)
├── docs/
│   ├── ON_DEVICE_AI.md              # Dedicated on-device AI technical guide
│   ├── PRIVACY_POLICY.md            # Google Play Privacy Policy (Markdown)
│   ├── privacy-policy.html          # Web-hosted Privacy Policy (HTML)
│   ├── ARCHITECTURE.md
│   ├── FEATURES.md
│   ├── API_INTEGRATIONS.md
│   ├── BUILD.md
│   └── CONTRIBUTING.md
├── android/
│   └── app/src/main/java/com/odineye/health/
│       ├── audio/                   # Native AudioTrack procedural sound engine
│       │   └── OdinAudioEngine.kt
│       ├── voice/                   # Native on-device speech recognizer & TTS
│       │   └── OdinEyeVoiceModule.kt
│       └── widget/                  # Native Android RemoteViews AppWidgets
│           ├── PillReminderWidgetProvider.kt
│           ├── ZenVitalsWidgetProvider.kt
│           └── OdinEyeWidgetModule.kt
└── src/
    ├── components/
    │   ├── ai/              # AI coach view + VoiceCoachOverlay
    │   ├── body/            # Body & muscle recovery + MobilityTimerModal
    │   ├── common/          # Shared UI (splash, modals, loaders)
    │   ├── home/            # Home tab cards, SleepArchitectureBentoCard, top bar
    │   ├── medication/      # Medication tracker, modals, icons
    │   ├── mindfulness/     # Full-screen Zen chamber, breath orb, mood check-in
    │   ├── navigation/      # FloatingTabBar with haptics
    │   ├── overview/        # Vitals tab (HealthOverviewView)
    │   ├── settings/        # Config tab (SettingsView & Widget Hub)
    │   └── sleep/           # Sleep bar chart
    ├── screens/
    │   ├── DashboardScreen.tsx   # Root shell — all tabs and global state
    │   └── OnboardingScreen.tsx  # 2-step onboarding + recalibration mode
    ├── services/
    │   ├── ai/              # AI engine, voiceCoachService, local coach, sports science KB
    │   ├── api/             # Ultrahuman, Fitbit, Hevy API clients
    │   ├── audio/           # Ambient sound service (native audio track bridge)
    │   ├── healthConnect/   # Android Health Connect integration
    │   ├── live/            # Live telemetry aggregator
    │   ├── medication/      # Medication service + OS notifications
    │   ├── mindfulness/     # Mindfulness streak & session logging service
    │   ├── mobility/        # Guided mobility routines & de-fatigue engine
    │   ├── security/        # AES-256 crypto utilities
    │   ├── sleep/           # Sleep history, debt & architecture analytics
    │   ├── storage/         # Encrypted credentials vault
    │   └── widgets/         # AppWidgets synchronization service
    ├── theme/
    │   └── colors.ts        # Scandinavian Pastel Bento palette
    └── types/               # Canonical TypeScript interfaces
        ├── index.ts         # Barrel export
        ├── health.ts
        ├── medication.ts
        ├── storage.ts
        ├── navigation.ts
        ├── devices.ts
        ├── mobility.ts
        ├── components.ts
        └── aiCoach.ts

See docs/BUILD.md for full instructions. If Expo is freezing or stuck on bundling on your device, consult the Troubleshooting Guide.

# Fastest — local USB build (requires Android Studio)
npx expo run:android

# Cloud build — preview APK (no Android Studio needed)
eas build --platform android --profile preview

# Production release build
eas build --platform android --profile production

Android package: com.odineye.health
EAS Project ID: df3fdf1c-a9bf-40e5-9c2e-ba21b8183b55
Troubleshooting: docs/TROUBLESHOOTING_EXPO_BUNDLING.md

Declared in app.json — all read-only:

READ_SLEEP · READ_HEART_RATE · READ_RESTING_HEART_RATE · READ_HEART_RATE_VARIABILITY
READ_EXERCISE · READ_TOTAL_CALORIES_BURNED · READ_ACTIVE_CALORIES_BURNED
READ_STEPS · READ_DISTANCE · READ_SKIN_TEMPERATURE · READ_OXYGEN_SATURATION
READ_RESPIRATORY_RATE · POST_NOTIFICATIONS · SCHEDULE_EXACT_ALARM · VIBRATE

Health Connect permissions only activate on a natively installed APK (com.odineye.health). They do not function inside Expo Go.