LifeGuard: Wearable Health & Environmental Monitoring System

Accessible health and environmental monitoring for everyone, everywhere.

View Demo · Report Bug · Request Feature

📋 Table of Contents

• 🌟 Overview
• ✨ Key Features
• 🛠️ Technical Specifications
• 🚀 Getting Started
• 🏗️ Project Structure
• 🧩 System Architecture
• 📚 API Documentation
• 👥 Team
• 📷 Screenshots
• 💬 Support & Contact

🌟 Overview

LifeGuard is an innovative wearable system that bridges critical gaps in personal safety, accessibility, and preventive healthcare. By integrating advanced sensors with machine learning algorithms, it delivers real-time insights on health metrics and environmental parameters, making safety monitoring accessible and affordable for all.

Our solution stands out as a cost-effective and comprehensive alternative to premium devices, enabling equitable access for underserved populations, including the elderly and industrial workers in developing regions.

60% Cheaper than Apple Watch

72h Battery Life

9 Integrated Sensors

IP67 Water Resistance

✨ Key Features

• 📊 Comprehensive Health Monitoring

  • Real-time vitals tracking
  • Fall detection with 95% accuracy
  • Activity recognition (walking, running, cycling)
  • Custom health thresholds

• 🌡️ Environmental Sensing

  • Air quality analysis (VOCs, CO2)
  • Temperature and humidity monitoring
  • Barometric pressure tracking
  • Pollution mapping with MapBox integration

• ⚠️ Smart Alert System

  • Emergency contact notifications
  • Geolocation sharing
  • Customizable thresholds
  • Automated emergency response

• 💼 Multi-Platform Support

  • Web dashboard with real-time analytics
  • Mobile app (iOS/Android) with dark/light themes
  • Data synchronization across devices
  • Offline functionality

🛠️ Technical Specifications

Hardware Components

Core Board	Arduino Nicla Sense ME
Power	3.7V LiPo Battery (400mAh)
Battery Life	72 hours with optimized power management
Durability	IP67 water and dust resistance
Weight	Approximately 45g (including enclosure)
Connectivity	BLE 5.0, WiFi (via companion device)
Sensors	• Accelerometer & Gyroscope (motion detection) • Temperature & Humidity sensors • Barometric pressure sensor • Magnetometer • Gas sensors (VOCs, CO2)

Software Architecture

Frontend	Backend	Mobile	ML & Analytics
• React 18 • TypeScript • Tailwind CSS • Redux Toolkit • MapBox API	• .NET 8.0 • PostgreSQL • JWT Auth • SendGrid • Firebase	• Flutter 3.19 • Provider State • Material 3 • Offline Mode • SharedPreferences	• LSTM Networks • TinyML Models • Edge Inference • Time-series Analysis • Sensor Fusion

🚀 Getting Started

Prerequisites

• Node.js 18+
• .NET SDK 8.0
• Flutter SDK 3.19+
• PostgreSQL 15+
• Arduino IDE (for firmware development)

Quick Start Guide

1. Clone the repository

git clone https://github.com/AWESOME04/LifeGuard.git
cd LifeGuard

2. Set up environment files

cp backend/.env.example backend/.env
cp node-server/.env.example node-server/.env
cp web/.env.example web/.env
cp mobile/.env.example mobile/.env

3. Start the backend server

cd backend
dotnet restore
dotnet run

4. Launch the web dashboard

cd web
npm install
npm start

5. Run the mobile application

cd mobile
flutter pub get
flutter run

Docker Setup

docker-compose up -d

This will start the web dashboard, API, and database services in containers.

🏗️ Project Structure

lifeguard/
├── .github/                    # GitHub actions and templates
├── firmware/                   # Arduino code and sketches
│   ├── test-sketches/          # Sketches to test Nicla Sense ME
│   └── we-dashboard/           # Web dashboard for reading sensor data
├── web/                        # React dashboard
│   ├── public/                 # Static assets
│   ├── src/                    # React components
│   │   ├── components/         # Reusable UI components
│   │   ├── pages/              # Main application views
│   │   ├── services/           # API integrations
│   │   └── store/              # Redux state management
├── mobile/                     # Flutter mobile app
│   ├── lib/                    # Dart code
│   │   ├── models/             # Data models
│   │   ├── screens/            # UI screens
│   │   ├── services/           # Business logic
│   │   └── widgets/            # Reusable components
├── backend/                    # .NET Core API
│   ├── Controllers/            # API endpoints
│   ├── Models/                 # Data structures
│   ├── Services/               # Business logic
│   └── Middleware/             # Request processing
├── node-server/                # Node.js backend service
│   ├── controllers/            # Route controllers
│   ├── models/                 # Database schemas
│   ├── routes/                 # API routes
│   ├── services/               # Business logic
│   ├── middleware/             # Express middleware
│   └── utils/                  # Helper functions
├── docs/                       # Documentation
│   ├── api/                    # API reference
│   ├── images/                 # Project images
│   └── tutorials/              # User guides
└── .devcontainer/              # Development container config

🧩 System Architecture

System Overview

Data Flow

1. Data Collection:

   • Sensors gather health and environmental data
   • Edge processing for initial analysis

2. Data Processing:

   • TinyML models analyze patterns on-device
   • Critical events trigger immediate alerts

3. Data Storage & Analysis:

   • Cloud storage with HIPAA-compliant encryption
   • Advanced analytics for long-term trends

4. User Interface:

   • Real-time dashboard visualization
   • Mobile alerts and insights

📚 API Documentation

Below is an overview of the core endpoints for the LifeGuard API.

Main Service Endpoints

These endpoints are served from the .NET-Server (hosted at https://lifeguard-hiij.onrender.com):

Auth Endpoints

Method	Endpoint	Description
GET	/	Health check or base endpoint
POST	/api/Account/login	Authenticate a user using email and password
POST	/api/Account/register	Register a new user account
POST	/api/Account/forgot-password	Initiate the password recovery process
POST	/api/Account/ResendOTP	Resend OTP to the user
POST	/api/Account/VerifyOTP	Verify the OTP provided by the user
POST	/api/Account/ResetPassword	Reset the user's password using a token
POST	/api/Account/CompleteProfile	Submit additional profile details
GET	/api/Account/{id}	Retrieve basic account information by ID
GET	/api/Account/GetProfile/{id}	Retrieve detailed user profile information
GET	/api/Account/google-login	Initiate Google OAuth authentication
GET	/api/Account/signin-google	Handle the Google OAuth callback
DELETE	/api/Account/{id}	Delete user profile information by ID

Photo Endpoints

Method	Endpoint	Description
POST	/{id}/photo	Upload a photo for the user with the specified ID
DELETE	/{id}/photo	Delete the user's photo identified by the given ID
GET	/{id}/photo	Retrieve the photo for the user with the specified ID

Node-Server Endpoints

These endpoints are served from the Node-Server (hosted at https://lifeguard-node.onrender.com):

Memo Endpoints

Method	Endpoint	Description
GET	/api/memos	Retrieve user memos
POST	/api/memos	Create a new memo
GET	/api/memos/undone/count	Retrieve the count of undone memos

Emergency Contact Endpoints

Method	Endpoint	Description
GET	/api/emergency-contacts	Retrieve user's emergency contacts
POST	/api/emergency-contacts	Add a new emergency contact
POST	/api/emergency-contacts/alert	Send emergency alert to contacts
GET	/api/emergency-contacts/test-alert/{id}	Send test alert to specific contact
GET	/api/emergency-contacts/verify	Verify emergency contact with token
GET	/api/emergency-contacts/alerts	Get history of sent emergency alerts

Health Metrics Endpoints

Method	Endpoint	Description
GET	/api/health-metrics/latest	Get the latest health metrics for user
POST	/api/health-metrics/save	Save new health metrics for user
GET	/api/health-metrics/history	Get health metrics history (last 10 entries)

Exercise Endpoints

Method	Endpoint	Description
GET	/api/exercise/stats	Retrieve user's exercise statistics and streaks
POST	/api/exercise/complete	Record a completed workout session
POST	/api/exercise/goals	Set or update user's workout goals
GET	/api/exercise/workout-history	Retrieve user's workout history
GET	/api/exercise/calories-history	Retrieve user's calories burned history
GET	/api/exercise/streak-history	Retrieve user's exercise streak history

Medication Endpoints

Method	Endpoint	Description
GET	/api/medications	Get all medications for current user
POST	/api/medications/add	Add a new medication
PUT	/api/medications/:id	Update medication by ID
DELETE	/api/medications/:id	Delete medication by ID
POST	/api/medications/track	Track medication dose (taken or skipped)
GET	/api/medications/compliance	Get medication compliance rate

Sound & Wellness Endpoints

Method	Endpoint	Description
POST	/api/freesound/audio-proxy	Proxy for streaming audio files from Freesound
GET	/api/favorite-sounds	Get all favorite sounds
GET	/api/favorite-sounds/{userId}	Get user's favorite sounds
DELETE	/api/favorite-sounds/{userId}/{soundId}	Remove a sound from favorites

RAG System Routes

Method	Endpoint	Description
POST	/api/rag/initialize	Initialize the RAG system (admin only)
POST	/api/rag/query	Query the RAG system (authenticated users)
POST	/api/rag/process/health	Process health data (authenticated users)
POST	/api/rag/process/environmental	Process environmental data (authenticated users)
POST	/api/rag/process/medical	Process medical knowledge (admin only)
POST	/api/rag/process/profiles	Process user profiles (authenticated users)

User Notification Preferences Endpoints

Method	Endpoint	Description
GET	/api/user-preferences/notifications	Get user notification preferences
POST	/api/user-preferences/notifications	Update user notification preferences
POST	/api/user-preferences/send-test-email	Send a test notification email to the user

Complete API documentation would be posted soon...

👥 Team

Core Developers

Evans Acheampong Frontend & Hardware

Michael Adu-Gyamfi Backend & ML

Academic Advisors

Dr. Percy Okae Project Supervisor

Chiratidzo Matowe Advisor

Marvin Rotermund Ambassador, Embedded Learning Challenge

📷 Screenshots

Appendix: Screenshots

Dashboard

Analytics Panel

Sticky Notes

Health Report

Pollution Map

Health Tips

Emergency Contacts

Help

Profile

Exercise Routines

Wellness Hub (Breathing)

Wellness Hub (Meditation)

Wellness Hub (Zen Sounds)

Health Metrics Calculator

💬 Support & Contact

Frontend: https://lifeguard-vert.vercel.app	Backend: https://lifeguard-hiij.onrender.com/api
Node Server: https://lifeguard-node.onrender.com	Email Support: [email protected] [email protected]

Happy coding!