🏥 SmartAid — Intelligent Health Companion SmartAid is a comprehensive, AI-powered mobile health companion built with Flutter and Firebase. It is designed to serve both patients (tracking daily medications, appointments, and health records) and doctors (viewing anonymized patient cohort analytics and research data).
The app bridges the gap between everyday health management and advanced technology by integrating:
🤖 Google Gemini AI for personalized health narrative insights
📷 ML Kit OCR for pill bottle camera verification
📡 Accelerometer-based fall detection with auto-SOS
🗺️ Live OpenStreetMap for nearby hospitals, clinics, and pharmacies
📊 Adherence analytics with visual charts and progress rings
📄 PDF report generation for patient health summaries
🔄 Offline-first sync so the app works without an internet connection
Feature
Description
Medication Tracking Add medications with daily dose limits and scheduled times. Log each dose with one tap.
Adherence Analytics Real-time adherence progress ring and weekly trend chart. Streak system for consecutive perfect days.
Appointment Booking Schedule, view, and edit upcoming doctor appointments.
AI Narrative Insights Gemini-powered personalized commentary on your adherence patterns.
Pill Scan Verification Use your phone's camera with Google ML Kit OCR to verify you have the right medication.
Emergency SOS Accelerometer-based fall detection with a 10-second countdown and auto-SMS/call to emergency contacts.
First Aid Guides Offline-capable first aid information for common emergencies.
Live Medical Map GPS-powered map showing nearby hospitals, clinics, and pharmacies (OpenStreetMap + Overpass API).
Health Records Vault Upload and store medical documents (PDFs, images) locally with Firestore metadata.
Medication Log History Full chronological history of all logged doses.
PDF Report Export Generate and share a comprehensive patient health report as a PDF.
Offline Mode Offline sync service queues changes when offline and syncs automatically when reconnected.
Theme Toggle Light, dark, and system-default themes.
Feature
Description
Doctor Dashboard Research overview with aggregate patient cohort metrics.
Consenting Patient List View patients who have opted in to share anonymized health data.
Cohort Analytics Summary statistics on medication adherence across the patient pool.
Research Insights AI-generated analysis of medication patterns at a population level.
SmartAid follows a layered, feature-first architecture with clean separation of concerns:
┌─────────────────────────────────────────────────────┐
│ Presentation Layer │
│ Screens / Widgets / Visualization Components │
├─────────────────────────────────────────────────────┤
│ Business Logic Layer │
│ Services · Providers · Analytics │
├─────────────────────────────────────────────────────┤
│ Data Layer │
│ Repositories · Models · Firestore │
├─────────────────────────────────────────────────────┤
│ Infrastructure / Cross-Cutting │
│ Firebase · SQLite (sqflite) · Offline Sync │
│ ML Kit · Sensors Plus · Gemini AI · PDF │
└─────────────────────────────────────────────────────┘
Provider + ChangeNotifierStreamBuilderFutureBuilderProxyProvider
go_routerNavigator.push
Technology
Purpose
Flutter 3.x / Dart ^3.9 Cross-platform UI framework
Firebase Auth Email/password authentication, role-based (patient vs. doctor)
Cloud Firestore Real-time NoSQL database for user data, medications, appointments, health records
Google Gemini AI (google_generative_ai)AI-generated health narrative and cohort insights
Technology
Purpose
Google ML Kit Text Recognition Camera-based pill bottle OCR verification
Sensors Plus Accelerometer access for fall detection
Technology
Purpose
Flutter Map OpenStreetMap tile rendering
Geolocator GPS location services
Overpass API (via http)Fetching nearby POIs (hospitals, clinics, pharmacies)
LatLong2 Coordinate data model
Technology
Purpose
sqflite Local SQLite database for offline queue
shared_preferences Light key-value persistence
path_provider Platform file system paths
file_picker User document uploads
open_filex Open saved files in native apps
Technology
Purpose
pdf Programmatic PDF document generation
printing PDF preview and share sheet
Technology
Purpose
Google Fonts Custom typography
Material 3 (useMaterial3: true)Modern adaptive design system
connectivity_plus Network status detection for offline mode
smart_aid/
└── lib/
├── main.dart # App entry, DI setup, GoRouter config
├── firebase_options.dart # Firebase platform config
│
├── models/ # Pure data classes (no logic)
│ ├── user_model.dart
│ ├── medication_model.dart
│ ├── dose_log_model.dart
│ ├── appointment_model.dart
│ ├── health_record_model.dart
│ ├── nearby_poi_model.dart
│ └── place_model.dart
│
├── repositories/ # Firestore data access layer
│ ├── user_repository.dart
│ ├── medication_repository.dart
│ ├── appointment_repository.dart
│ ├── health_record_repository.dart
│ ├── doctor_dashboard_repository.dart
│ └── places_repository.dart # Overpass API integration
│
├── services/ # Business logic layer
│ ├── user_service.dart
│ ├── medication_service.dart # Dose logging, streams
│ ├── appointment_service.dart
│ ├── health_record_service.dart
│ ├── fall_detection_service.dart # Accelerometer + SOS
│ ├── pill_verification_service.dart # ML Kit OCR
│ ├── pdf_export_service.dart # PDF generation & sharing
│ └── local_db_service.dart # SQLite offline queue
│
├── screens/ # UI screens (one per feature)
│ ├── auth_screen.dart
│ ├── main_screen.dart # Tab host
│ ├── home_screen.dart # Medications + appointments + insights
│ ├── add_medicine_screen.dart
│ ├── add_appointment_screen.dart
│ ├── health_records_screen.dart
│ ├── nearby_hospitals_screen.dart
│ ├── emergency_screen.dart # Fall detection + SOS
│ ├── first_aid_screen.dart
│ ├── profile_screen.dart # Settings, emergency contacts, privacy
│ ├── doctor_dashboard_screen.dart
│ └── language_selection_screen.dart
│
├── analytics/ # Analytics engine
│ ├── models/
│ │ └── doctor_dashboard_stats.dart
│ ├── services/
│ │ ├── adherence_analytics_service.dart
│ │ └── research_analytics_service.dart
│ └── intelligence/
│ ├── models/
│ │ └── product_insight.dart
│ └── services/
│ └── product_insights_service.dart
│
├── ai/ # Gemini AI integration
│ ├── models/
│ ├── prompts/
│ ├── services/
│ │ └── ai_insight_service.dart
│ └── widgets/
│ └── ai_narrative_widget.dart
│
├── reports/ # Report generation
│ ├── models/
│ └── services/
│ └── report_generation_service.dart
│
├── offline/ # Offline-first sync
│ ├── models/
│ └── services/
│ └── offline_sync_service.dart
│
├── security/
│ ├── services/
│ │ └── secure_logger.dart
│ └── validators/
│ └── input_validators.dart
│
├── visualization/ # Charting widgets
│ ├── models/
│ │ └── chart_point.dart
│ ├── utils/
│ │ └── chart_data_mapper.dart
│ └── widgets/
│ ├── adherence_progress_ring.dart
│ ├── weekly_trend_chart.dart
│ └── cohort_summary_widget.dart
│
├── providers/
│ └── theme_provider.dart
│
├── theme/
│ └── app_theme.dart
│
├── ui/
│ └── loading/
│ └── shimmer_loading.dart # Skeleton loading cards
│
├── utils/
│ └── firestore_parser.dart
│
└── widgets/
└── bottom_nav_bar.dart
Authentication (auth_screen.dart)
Combined login / sign-up screen
Doctor role toggle during registration
Firebase Auth email/password with error feedback
Branding logo display
Home Screen (home_screen.dart)
Upcoming Appointments — horizontal scrollable card list with real-time Firestore streamToday's Insights — adherence ring + weekly trend chart + AI narrative + streak badgeMedications List — tap-to-log daily medications, strikethrough when takenOffline indicator in app bar (pending sync count + syncing spinner)FAB to add medicine or book appointmentQuick access to Emergency SOS and PDF export from action buttons
Emergency Screen (emergency_screen.dart)
Toggle switch to activate accelerometer-based fall monitoring
On fall detected: full-screen warning, 10-second countdown, cancel button
On countdown expiry: auto-SMS to emergency contacts + auto-dial 108 (ambulance)
Link to First Aid Guides
Nearby Hospitals Screen (nearby_hospitals_screen.dart)
Live interactive map (OpenStreetMap tiles)
Category filter chips: Hospitals / Clinics / Pharmacies
GPS location with fallback to New Delhi default
Retry logic with exponential backoff for the Overpass API
Tap markers for place name details in a bottom sheet
Health Records Screen (health_records_screen.dart)
Tab 1 — Uploaded Files : Upload any file (PDF, image), stored locally + Firestore metadata, open / deleteTab 2 — Medication Logs : Full history of all dose log entries with timestampsPDF export of full patient report
Doctor Dashboard (doctor_dashboard_screen.dart)
Cohort research overview with aggregate statistics
List of consenting patients with opt-in privacy model
CohortSummaryWidget with AI-generated insight
Profile Screen (profile_screen.dart)
User email display
Emergency contacts management (add / remove phone numbers)
Theme toggle (light / dark / system)
Privacy consent toggle for research data sharing
Sign out
uid: String
email: String
isDoctor: bool
emergencyContacts: List <String >
shareDataResearch: bool
createdAt: DateTime id: String
userId: String
name: String
dailyDoseLimit: int
scheduledTimes: List <String > // e.g. ["08:00", "20:00"]
createdAt: DateTime medicationId: String
medicationName: String
userId: String
date: String // "yyyy-MM-dd" key
count: int // doses taken today
lastTaken: DateTime id: String
userId: String
doctorName: String
reason: String
dateTime: DateTime id: String
userId: String
fileName: String
localPath: String
createdAt: DateTime ⚙️ Services & Repositories Repository Layer (Firestore Access)
Repository
Firestore Collections
UserRepositoryusers/{uid}
MedicationRepositoryusers/{uid}/medications, users/{uid}/dose_logs
AppointmentRepositoryusers/{uid}/appointments
HealthRecordRepositoryusers/{uid}/health_records
DoctorDashboardRepositoryAggregates across users collection
PlacesRepositoryOverpass API (external HTTP)
Service Layer (Business Logic)
Service
Responsibility
MedicationServiceCRUD medications, dose logging, real-time streams
AppointmentServiceCRUD appointments, upcoming filter
HealthRecordServiceUpload metadata, local file management
UserServiceProfile updates, emergency contacts, consent
FallDetectionServiceAccelerometer monitoring, countdown, SOS dispatch
PillVerificationServiceCamera capture → ML Kit OCR → fuzzy name match
PdfExportServicePDF document generation and platform share
LocalDbServiceSQLite queue for offline operations
OfflineSyncServiceMonitors connectivity, replays queued Firestore writes
Patient Analytics (ProductInsightsService)
Generates a PatientAdherenceProfile
todayStats (expected vs taken doses)weeklyTimeline (7-day adherence history)consecutivePerfectDays (streak counter)dailyInsight (sentiment-aware message: positive / neutral / warning)
Research Analytics (ResearchAnalyticsService)
Aggregates anonymized data from consenting patients
Streams DoctorDashboardStats
Adherence Analytics (AdherenceAnalyticsService)
Per-medication adherence rate calculations over configurable time windows
Gemini AI (AiInsightService + AiNarrativeWidget)
Sends adherence context to Google Gemini via google_generative_ai
Returns a personalized, human-readable narrative displayed in the home screen insight card
API key injected at build time via --dart-define=GEMINI_API_KEY=...
Widget
Description
AdherenceProgressRingAnimated circular progress ring showing today's dose completion %
WeeklyTrendChart7-bar chart mapping weekly adherence trend
CohortSummaryWidgetDoctor-facing aggregate summary card
Firebase Auth enforces authentication before any data accessFirestore Security Rules (configured via Firebase console) restrict each user to their own data path (users/{uid}/**)Doctor role stored in Firestore and checked for dashboard accessPrivacy consent model : patients must explicitly opt in to share research data (shareDataResearch flag)SecureLoggerInputValidatorsEmergency contacts stored per-user and only accessed on the device during SOS; never broadcast to third parties beyond the user-initiated SMS
Flutter SDK ^3.9.0
Dart ^3.9.0
Firebase project with Authentication and Cloud Firestore enabled
(Optional) Google Gemini API key for AI narratives
git clone https://github.com/jeevan841/SmartAid.git
cd SmartAid/smart_aid
flutter pub get # Android / iOS# Web# WindowsRun with Gemini AI enabled flutter run --dart-define=GEMINI_API_KEY=your_key_here
Create a Firebase project at console.firebase.google.com
Enable Authentication (Email/Password provider)
Enable Cloud Firestore (start in test mode, then apply security rules)
Run flutterfire configure to regenerate firebase_options.dart
Firestore Security Rules (recommended) rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /users/{uid}/{document=**} {
allow read, write: if request.auth != null && request.auth.uid == uid;
}
}
}
Icons are auto-generated via flutter_launcher_icons from assets/images/logo.png:
dart run flutter_launcher_icons
See UML_DIAGRAM.md
Status
Feature
✅
Medication tracking & dose logging
✅
Appointment scheduling
✅
AI-powered adherence narratives (Gemini)
✅
Fall detection with auto-SOS
✅
Pill verification via OCR
✅
Live medical map (hospitals, clinics, pharmacies)
✅
Health records file vault
✅
PDF health report export
✅
Doctor research dashboard
✅
Offline-first sync
✅
Multi-language screen scaffold
🔜
Push notifications for missed doses
🔜
Wearable (smartwatch) integration
🔜
Prescription photo-to-schedule import
🔜
Multi-language full localization (i18n)
🔜
Telemedicine in-app video call
Contributions are welcome! Please open an issue to discuss your idea before submitting a pull request.
Fork the repository
Create your feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a pull request
This project is licensed under the MIT License — see the LICENSE file for details.
Made with ❤️ using Flutter & Firebase
