WearaBridge 🏥📱

Cross-platform mobile health data sync application. WearaBridge connects to Health Connect (Android) and HealthKit (iOS) to automatically sync health data to your backend in the background.

Overview

WearaBridge is a simple Flutter mobile app that:

✅ Auto-generates unique device ID on first launch
✅ Syncs health data automatically every 30 minutes (no login required)
✅ Shows 5-digit pairing code that refreshes every 30 seconds
✅ Users claim devices via web dashboard using the code
✅ Works with any backend - see API_REQUIREMENTS.md

Quick Start

Configure backend URL in lib/core/config/app_config.dart:

static const String apiBaseUrl = 'https://your-backend.com';

Backend Integration - Share API_REQUIREMENTS.md with your backend team
Install dependencies:
```
flutter pub get
```
Run:
```
flutter run
```

How Pairing Works

App generates unique device ID (UUID) on first launch
App starts syncing health data immediately with device IDin header
User opens pairing screen, app requests 5-digit code from backend
Backend generates code (valid 30 seconds) linked to device ID
User enters code in web dashboard to claim device
Backend associates device ID with user account
Historical data now visible under user's account

Architecture

wearabridge/
├── lib/
│   ├── main.dart                          # App entry point
│   ├── core/
│   │   ├── config/app_config.dart        # API endpoints & configuration
│   │   ├── constants/health_data_types.dart
│   │   └── network/api_client.dart       # HTTP client with auth
│   ├── data/
│   │   ├── datasources/
│   │   │   ├── health_datasource.dart    # Health Connect/HealthKit wrapper
│   │   │   └── api_datasource.dart       # Backend API calls
│   │   ├── models/
│   │   │   └── health_data_point.dart    # Data models
│   │   └── repositories/
│   │       └── health_repository.dart    # Business logic layer
│   ├── services/
│   │   ├── background_sync_service.dart  # WorkManager background tasks
│   │   └── auth_service.dart             # Authentication
│   └── presentation/
│       ├── screens/                      # UI screens
│       ├── widgets/                      # Reusable widgets
│       └── providers/                    # Riverpod state management

Health Data Types Supported

Steps - Daily step count
Heart Rate - Continuous heart rate measurements
Sleep - Sleep sessions with quality data
Workouts - Exercise activities
Distance - Distance traveled
Active Calories - Calories burned during activity
Blood Oxygen - SpO2 readings
Resting Heart Rate - RHR measurements

Setup

Prerequisites

Flutter SDK 3.9.2+
Android Studio (for Android development)
Xcode (for iOS development)

Installation

Install dependencies:
```
cd wearabridge
flutter pub get
```

Configure backend URL: Edit lib/core/config/app_config.dart:

static const String apiBaseUrl = 'https://your-backend.com'; // CHANGE THIS

Backend Setup:
- Share API_REQUIREMENTS.md with your backend team
- Backend needs to implement 4 endpoints (see API_REQUIREMENTS.md)
- No authentication on mobile app side - device ID only
Android Setup:
- Health Connect requires Android 14+ or the Health Connect APK
- Permissions configured in AndroidManifest.xml
iOS Setup:
- HealthKit permissions configured in Info.plist
- Requires iOS 13.0+
Run:
```
flutter run
```

Background Sync

The app uses WorkManager to schedule periodic background syncs:

Frequency: Every 30 minutes (configurable)
Constraints: Requires network connection, battery not low
Retry Policy: Exponential backoff on failure
Data: Syncs data since last successful sync (up to 7 days lookback)

How it Works

App registers periodic background task on login
Task wakes up every 30 minutes
Fetches new health data from Health Connect/HealthKit
Batches data and sends POST request to /v1/health/sync
Updates last sync timestamp
Retries on failure with exponential backoff

API Integration

Backend Endpoint

The app syncs to: POST /v1/health/sync

Request Body:

{
  "userId": "user_123",
  "deviceType": "android",
  "syncedAt": "2026-02-26T10:30:00Z",
  "lastSyncTime": "2026-02-26T10:00:00Z",
  "data": [
    {
      "type": "STEPS",
      "value": "1250",
      "unit": "count",
      "dateFrom": "2026-02-26T10:00:00Z",
      "dateTo": "2026-02-26T10:30:00Z",
      "sourcePlatform": "HEALTH_CONNECT",
      "sourceDevice": "Pixel 8",
      "metadata": {}
    }
  ]
}

Response (201):

{
  "success": true,
  "stored": 1,
  "syncedAt": "2026-02-26T10:30:00Z"
}

Screens

1. Splash Screen

Auto-navigates to Login or Home based on auth state

2. Login Screen

Email/password authentication
Connects to existing bodypress-backend auth system

3. Home Screen (Dashboard)

Shows sync status and last sync time
Displays today's stats (steps, heart rate, sleep)
Pull-to-refresh for manual sync
Requests permissions if not granted

4. Settings Screen

Manage sync frequency
Toggle background sync on/off
View/request health permissions
Logout

Security

🔐 Auth tokens stored in flutter_secure_storage
🔒 API calls authenticated with Bearer token
⚠️ Health data never stored locally except in platform's secure health storage
🌐 HTTPS required for all API communication
🚫 No third-party analytics or tracking

Platform Requirements

Android

Minimum SDK: 26 (Android 8.0)
Target SDK: 34 (Android 14)
Health Connect installed (built-in on Android 14+)
Permissions declared in AndroidManifest.xml

iOS

Minimum: iOS 13.0
HealthKit capability enabled
Privacy strings in Info.plist
Background modes: fetch, processing

Development

Running in Debug Mode

flutter run --debug

Building for Release

Android:

flutter build apk --release
# or
flutter build appbundle --release

iOS:

flutter build ios --release

Code Generation

For Freezed models and Riverpod providers:

flutter pub run build_runner build --delete-conflicting-outputs

Testing

Unit Tests

flutter test

Integration Tests

flutter test integration_test

Deployment

Android (Play Store)

Requires Health Connect certification from Google
Submit app for review with health permissions usage explanation

iOS (App Store)

Requires clear explanation of HealthKit usage in App Review
Privacy policy mandatory

Configuration Options

Edit lib/core/config/app_config.dart:

// Sync every 15 minutes instead of 30
static const Duration syncInterval = Duration(minutes: 15);

// Change batch size
static const int batchSize = 50;

// Adjust retry attempts
static const int maxRetries = 5;

Troubleshooting

Android: Health Connect not found

Install Health Connect from Play Store
Or use Android 14+ which has it built-in

iOS: Permissions not showing

Check Info.plist has NSHealthShareUsageDescription
Rebuild the app after adding permissions

Background sync not working

Check battery optimization settings
Ensure network connectivity
View logs: flutter logs

API authentication failing

Verify backend is running
Check API endpoint in app_config.dart
Ensure user is logged in

Future Enhancements

Tech Stack

Framework: Flutter 3.9.2+
Language: Dart
State Management: Riverpod
HTTP Client: Dio
Health Data: health package
Background Tasks: workmanager
Local Storage: flutter_secure_storage, shared_preferences
Database (Backend): PostgreSQL + Prisma

Contributing

Fork the repository
Create feature branch (git checkout -b feature/amazing-feature)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Open Pull Request

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
android		android
ios		ios
lib		lib
linux		linux
macos		macos
test		test
web		web
windows		windows
.gitignore		.gitignore
.metadata		.metadata
API_REQUIREMENTS.md		API_REQUIREMENTS.md
README.md		README.md
analysis_options.yaml		analysis_options.yaml
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Folders and files

Latest commit

History

Repository files navigation

WearaBridge 🏥📱

Overview

Quick Start

How Pairing Works

Architecture

Health Data Types Supported

Setup

Prerequisites

Installation

Background Sync

How it Works

API Integration

Backend Endpoint

Screens

1. Splash Screen

2. Login Screen

3. Home Screen (Dashboard)

4. Settings Screen

Security

Platform Requirements

Android

iOS

Development

Running in Debug Mode

Building for Release

Code Generation

Testing

Unit Tests

Integration Tests

Deployment

Android (Play Store)

iOS (App Store)

Configuration Options

Troubleshooting

Android: Health Connect not found

iOS: Permissions not showing

Background sync not working

API authentication failing

Future Enhancements

Tech Stack

Contributing

License

A

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages