FlowFit

A comprehensive health and fitness tracking application for Wear OS (Galaxy Watch) with companion phone app support. Built with Flutter and integrated with Samsung Health Sensor SDK.

flutter run -d adb-RFAX21TD0NA-FFYRNh._adb-tls-connect._tcp -t lib/main_wear.dart flutter run -d 6ece264d -t lib/main.dart

📁 Project recently reorganized! All documentation is now in docs/ and scripts in scripts/. See docs/INDEX.md for complete documentation index.

🎯 Overview

FlowFit is a dual-platform fitness app that runs on:

• Galaxy Watch (Wear OS) - Primary device for real-time health tracking
• Android Phone - Companion app for data visualization and management

Key Features

• ✅ Real-time Heart Rate Monitoring - Continuous HR tracking with Samsung Health Sensor SDK
• ✅ Inter-Beat Interval (IBI) Data - Advanced HRV analysis
• ✅ Activity Tracking - Workout logging and exercise monitoring
• ✅ Sleep Tracking - Sleep mode with sensor integration
• ✅ Nutrition Logging - Food diary and calorie tracking
• ✅ Mood Tracking - Mental wellness monitoring
• ✅ Data Synchronization - Watch ↔ Phone data transfer
• ✅ Supabase Backend - Cloud storage and sync

🏗️ Architecture

┌─────────────────────────────────────┐
│     Galaxy Watch (Wear OS)          │
│  - Heart rate monitoring            │
│  - Activity tracking                │
│  - Sleep tracking                   │
│  - Real-time sensor data            │
└──────────────┬──────────────────────┘
               │ Wearable Data Layer
               │ (MessageClient/DataClient)
┌──────────────▼──────────────────────┐
│     Android Phone (Companion)       │
│  - Data visualization               │
│  - Historical analysis              │
│  - Detailed reports                 │
│  - Settings management              │
└──────────────┬──────────────────────┘
               │ Supabase API
┌──────────────▼──────────────────────┐
│     Supabase Backend                │
│  - PostgreSQL database              │
│  - Real-time subscriptions          │
│  - Authentication                   │
│  - Cloud storage                    │
└─────────────────────────────────────┘

📱 Devices

Watch Device (SM_R930)

• Model: Galaxy Watch (SM_R930)
• Device ID: adb-RFAX21TD0NA-FFYRNh._adb-tls-connect._tcp
• Platform: Wear OS powered by Samsung
• Purpose: Primary health tracking device
• Run Command: flutter run -d adb-RFAX21TD0NA-FFYRNh._adb-tls-connect._tcp -t lib/main_wear.dart

Phone Device (22101320G)

• Model: Android Phone (22101320G)
• Device ID: 6ece264d
• Purpose: Companion app for data visualization
• Run Command: flutter run -d 6ece264d -t lib/main.dart

🚀 Quick Start

Prerequisites

Hardware:

• Galaxy Watch4 or higher (Wear OS 3.0+)
• Android phone (API 23+)
• Both devices paired via Galaxy Wearable app

Software:

• Flutter SDK (3.10.0+)
• Android Studio with Kotlin support
• Samsung Health app installed on watch
• Supabase account (for backend)

Installation

1. Clone and setup

   git clone <repository-url>
   cd flowfit
   flutter pub get

2. Configure Supabase

   • Copy lib/secrets.dart.example to lib/secrets.dart
   • Add your Supabase URL and anon key

3. Deploy to devices

   # Watch app
   scripts\test-watch.bat
   
   # Phone app (in another terminal)
   scripts\test-phone.bat

Testing Connection

1. Start phone app first
2. Start watch app
3. On watch: tap "Heart Rate" → "START"
4. Wait for heart rate reading
5. Tap "SEND" → check phone receives data

Troubleshooting? See WATCH_CONNECTION_GUIDE.md

🔧 Samsung Health Sensor Integration

Setup

The app uses Samsung Health Sensor SDK for real-time heart rate monitoring. See detailed setup guides:

• QUICK_START.md - 5-minute quick start
• SAMSUNG_HEALTH_SETUP_GUIDE.md - Complete setup guide
• IMPLEMENTATION_CHECKLIST.md - Testing checklist

Usage Example

import 'package:flowfit/services/watch_bridge.dart';

final watchBridge = WatchBridgeService();

// 1. Request permission
await watchBridge.requestBodySensorPermission();

// 2. Connect to Samsung Health
await watchBridge.connectToWatch();

// 3. Start tracking
await watchBridge.startHeartRateTracking();

// 4. Listen to heart rate data
watchBridge.heartRateStream.listen((data) {
  print('Heart Rate: ${data.bpm} BPM');
  print('IBI Values: ${data.ibiValues}');
});

// 5. Stop tracking
await watchBridge.stopHeartRateTracking();

Heart Rate Data Structure

HeartRateData {
  bpm: 72,                    // Heart rate in beats per minute
  ibiValues: [850, 845, 855], // Inter-beat intervals (ms)
  timestamp: DateTime.now(),   // When reading was taken
  status: SensorStatus.active  // active, inactive, error
}

📊 Features

Watch App Features

1. Clean Dashboard (lib/screens/wear/wear_dashboard.dart)

   • Single large "Heart Rate" button
   • Minimal, focused design
   • Optimized for small screens

2. Heart Rate Monitor (lib/screens/wear/wear_heart_rate_screen.dart)

   • Large BPM display (56pt font)
   • Simple START/STOP button
   • One-tap SEND to phone
   • Real-time status indicator
   • Samsung Health SDK integration
   • IBI data collection

Phone App Features

1. Dashboard (lib/screens/dashboard.dart)

   • Overview of all health metrics
   • Historical data charts
   • Sync status

2. Workout Library (lib/screens/workout/workout_library.dart)

   • Exercise database
   • Workout history
   • Performance analytics

3. Nutrition Logger (lib/screens/nutrition/food_logger.dart)

   • Food diary
   • Calorie tracking
   • Nutritional analysis

🔌 Data Synchronization

Watch → Phone Transfer

The app uses Wearable Data Layer API for real-time data transfer:

// On Watch: Send heart rate data
messageClient.sendMessage(
  nodeId,
  "/heart_rate",
  jsonEncode(heartRateData)
);

// On Phone: Receive data
class DataListenerService extends WearableListenerService {
  @override
  void onMessageReceived(MessageEvent messageEvent) {
    final data = jsonDecode(messageEvent.data);
    // Process and display data
  }
}

Supabase Sync

Both devices sync to Supabase for persistent storage:

// Save heart rate to Supabase
await supabase.from('heart_rates').insert({
  'user_id': userId,
  'bpm': heartRateData.bpm,
  'timestamp': heartRateData.timestamp.toIso8601String(),
  'ibi_values': heartRateData.ibiValues,
});

🗂️ Project Structure

flowfit/
├── android/
│   ├── app/
│   │   ├── libs/
│   │   │   └── samsung-health-sensor-api-1.4.1.aar
│   │   └── src/main/kotlin/com/example/flowfit/
│   │       ├── MainActivity.kt
│   │       └── HealthTrackingManager.kt
│   └── build.gradle.kts
├── lib/
│   ├── main.dart                    # Phone app entry
│   ├── main_wear.dart               # Watch app entry
│   ├── models/
│   │   ├── heart_rate_data.dart
│   │   ├── activity.dart
│   │   ├── sleep_session.dart
│   │   └── mood_log.dart
│   ├── services/
│   │   ├── watch_bridge.dart        # Samsung Health SDK bridge
│   │   ├── supabase_service.dart    # Backend service
│   │   └── sleep_service.dart
│   ├── screens/
│   │   ├── wear/                    # Watch-specific screens
│   │   ├── workout/
│   │   ├── sleep/
│   │   └── nutrition/
│   └── examples/
│       └── heart_rate_example.dart
├── docs/                            # Documentation
│   ├── QUICK_START.md
│   ├── SAMSUNG_HEALTH_SETUP_GUIDE.md
│   ├── IMPLEMENTATION_CHECKLIST.md
│   ├── INSTALLATION_TROUBLESHOOTING.md
│   ├── BUILD_FIXES_APPLIED.md
│   ├── HEART_RATE_DATA_FLOW.md
│   ├── WEAR_OS_SETUP.md
│   ├── RUN_INSTRUCTIONS.md
│   ├── VGV_IMPROVEMENTS.md
│   └── WEAR_OS_IMPROVEMENTS.md
├── scripts/                         # Build and run scripts
│   ├── build_and_install.bat
│   ├── run_watch.bat
│   └── run_phone.bat
├── pubspec.yaml
└── README.md

🐛 Troubleshooting

Build Issues

"Unresolved reference: ConnectionListener"

# Clean and rebuild
flutter clean
flutter pub get
flutter run -d <device-id>

"JVM-target compatibility detected"

• Check android/app/build.gradle.kts
• Ensure jvmTarget = "17" is set

Runtime Issues

"Connection Failed" on Watch

• Ensure Samsung Health is installed
• Check watch supports Samsung Health Sensor SDK
• Restart watch and try again

"Permission Denied"

• Go to Settings → Apps → FlowFit → Permissions
• Enable "Body sensors" permission

No Heart Rate Data

• Wear watch on wrist (sensor needs skin contact)
• Tighten watch band
• Clean sensor on back of watch

Data Sync Issues

Watch not sending data to phone

• Check both devices are paired
• Verify Galaxy Wearable app is running
• Check network connectivity

Supabase sync failing

• Verify secrets.dart configuration
• Check internet connection
• Review Supabase logs

📚 Documentation

📖 Complete Documentation Index - Full list of all documentation

🚀 Quick Links

• QUICK_START.md - ⭐ Start here! Quick guide to run and test the app
• NAVIGATION_GUIDE.md - 🗺️ How to access heart rate monitoring UI
• GETTING_STARTED.md - Initial setup guide
• WATCH_TO_PHONE_COMPLETE_FLOW.md - Live data flow from watch to phone
• ALL_ISSUES_FIXED.md - Summary of all fixes applied
• KOTLIN_COMPARISON_ANALYSIS.md - Architecture comparison

🐛 Troubleshooting

• CONNECTION_TIMEOUT_FIX.md - Connection issues
• PHONE_RECEIVER_ISSUE.md - Phone data reception
• SMARTWATCH_TO_PHONE_DATA_FLOW.md - Complete data flow guide

🔐 Permissions

Watch App Permissions

• BODY_SENSORS - Heart rate and health sensors
• FOREGROUND_SERVICE - Background tracking
• FOREGROUND_SERVICE_HEALTH - Health-specific services
• WAKE_LOCK - Keep device awake during tracking
• ACTIVITY_RECOGNITION - Activity detection

Phone App Permissions

• INTERNET - Supabase sync
• ACCESS_NETWORK_STATE - Network status
• WAKE_LOCK - Background sync

🛠️ Tech Stack

• Frontend: Flutter 3.10.0+
• Language: Dart
• Backend: Supabase (PostgreSQL)
• Watch SDK: Samsung Health Sensor SDK 1.4.1
• Wearable: Wear OS 3.0+
• Communication: Wearable Data Layer API
• State Management: Provider
• Charts: fl_chart
• Location: geolocator, google_maps_flutter
• Sensors: sensors_plus, wear_plus

📈 Roadmap

• Complete watch-to-phone data transfer implementation
• Add workout heart rate zones
• Implement HRV analysis and trends
• Add resting heart rate calculation
• Background heart rate monitoring
• Heart rate alerts (too high/low)
• Sleep quality scoring
• Nutrition recommendations
• Social features and challenges

🤝 Contributing

Contributions are welcome! Please read the contributing guidelines before submitting PRs.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Samsung Health Sensor SDK
• Flutter team
• Supabase team
• VGV (Very Good Ventures) for Wear OS best practices

📞 Support

For issues and questions:

1. Check the troubleshooting section above
2. Review the documentation files
3. Check logcat: adb logcat | grep -i health
4. Open an issue on GitHub

---

🚀 Quick Commands

Build & Install

# Automated build and install on watch
scripts\build_and_install.bat

# Run on watch
scripts\run_watch.bat

# Run on phone
scripts\run_phone.bat

Manual Commands

# Watch (SM_R930 - Galaxy Watch)
flutter run -d adb-RFAX21TD0NA-FFYRNh._adb-tls-connect._tcp -t lib/main_wear.dart

# Phone (22101320G)
flutter run -d 6ece264d -t lib/main.dart

⚠️ Important: Always use -t lib/main_wear.dart for watch to get Wear OS UI, not phone UI!

Troubleshooting

# View logs
adb -s 6ece264d logcat | findstr "FlowFit"

# Check devices
adb devices

# Uninstall
adb -s 6ece264d uninstall com.example.flowfit

---

For detailed documentation, see the docs/ folder.