FamFitAI – Multi-User Fitbit Health Monitoring App

Job ID: 40018333

Budget: $250 – $750 USD

FamFitAI is a mobile application that allows a caregiver (such as an adult child) to monitor the real-time health and wellness of multiple family members—like parents or grandparents—using Fitbit wearable data.

Each person connects their Fitbit account through a secure OAuth 2.0 flow. Once connected, the app automatically syncs their activity, sleep, and heart-related metrics from Fitbit.

The caregiver can then see detailed health dashboards, high-level summaries, alerts, and AI-generated insights for each monitored person.

The system consists of:
• iOS app (SwiftUI)
• FastAPI backend (Python)
• Database (SQLite or PostgreSQL)
• Fitbit API integration
• Domain: famfit.dev with HTTPS

✅ Core Features

1. Multi-Person Health Monitoring
• The caregiver sees a dashboard of parents/loved ones.
• Each person shows:
• Fitbit connection status
• Last sync time
• Summary of daily metrics

2. Fitbit OAuth Integration
• Secure OAuth 2.0 login for each family member
• API token storage + refresh support
• Server-side Fitbit synchronization

3. Real Data Sync via Fitbit Web APIs

Pull metrics:
• Steps
• Distance
• Calories burned
• Active minutes
• Resting heart rate
• Average daily heart rate
• Sleep stages (light, deep, REM, awake)
• Sleep efficiency
• Weekly stats (averages & goals)

4. Parent Detail Dashboard

Visual presentation of:
• Daily activity chart
• Heart rate summary
• Sleep breakdown
• Weekly trend metrics

5. Status & Edge Case Handling
• Connected / not connected
• Connected but no data
• Sync failed
• Last synced timestamp
• Proper empty-state UX

6. Backend System
• Unified ParentSnapshot data model
• FitbitConnection model (access_token, refresh_token)
• Secure HTTPS via Nginx + Certbot
• OAuth endpoints:
• /auth/fitbit/login
• /auth/fitbit/callback
• API endpoints:
• /api/parents
• /api/parents/{id}/snapshot

7. (Optional Add-ons for phase 2)
• AI-generated daily/weekly health summaries
• Push notifications for:
• low activity
• poor sleep
• unusual heart rate
• Multi-user authentication
• Admin dashboard (web)

✅ Deliverables Expected From Outsourced Team

iOS
• Fully working SwiftUI app
• Screens:
• Dashboard
• Parent detail screen
• Connect Fitbit flow
• API integration
• Error + empty-state handling
• Clean architecture (MVVM preferred)

Backend
• Fully working FastAPI service
• OAuth implementation
• Fitbit sync logic
• Database models
• All endpoints functional

QA
• Token expiration scenarios tested
• No crashes on empty or missing data
• Graceful sync failure handling

Deployment
• Backend deployed on your server
• HTTPS configured
• Systemd service running uvicorn
• Logs + health checks in place
Related categories: Python Swift OAuth Swift Package Manager