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

Clone and setup

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

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

Deploy to devices

# Watch app
scripts\test-watch.bat

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

Testing Connection

Start phone app first
Start watch app
On watch: tap "Heart Rate" → "START"
Wait for heart rate reading
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

Clean Dashboard (lib/screens/wear/wear_dashboard.dart)
- Single large "Heart Rate" button
- Minimal, focused design
- Optimized for small screens
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

Dashboard (lib/screens/dashboard.dart)
- Overview of all health metrics
- Historical data charts
- Sync status
Workout Library (lib/screens/workout/workout_library.dart)
- Exercise database
- Workout history
- Performance analytics
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:

Check the troubleshooting section above
Review the documentation files
Check logcat: adb logcat | grep -i health
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.

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

FlowFit

🎯 Overview

Key Features

🏗️ Architecture

📱 Devices

Watch Device (SM_R930)

Phone Device (22101320G)

🚀 Quick Start

Prerequisites

Installation

Testing Connection

🔧 Samsung Health Sensor Integration

Setup

Usage Example

Heart Rate Data Structure

📊 Features

Watch App Features

Phone App Features

🔌 Data Synchronization

Watch → Phone Transfer

Supabase Sync

🗂️ Project Structure

🐛 Troubleshooting

Build Issues

Runtime Issues

Data Sync Issues

📚 Documentation

🚀 Quick Links

🐛 Troubleshooting

🔐 Permissions

Watch App Permissions

Phone App Permissions

🛠️ Tech Stack

📈 Roadmap

🤝 Contributing

📄 License

🙏 Acknowledgments

📞 Support

🚀 Quick Commands

Build & Install

Manual Commands

Troubleshooting