🏥 Digital Healthcare Assistance

AI-Powered Healthcare at Your Fingertips

A comprehensive Flutter mobile application that bridges the gap between patients and healthcare services using artificial intelligence and real-time data management.

• Overview
• Features
• Prerequisites
• Installation
• Configuration
• Project Structure
• Usage
• Architecture
• Contributing
• License
• Support

Digital Healthcare Assistance is a modern healthcare management application built with Flutter and Firebase. It leverages AI-powered symptom analysis using the Groq API to provide preliminary health assessments, helps users find and book appointments at hospitals, manage bed reservations, and streamlines healthcare staff workflows.

The application is designed with a multi-user architecture supporting:

• Patients - Access healthcare services and symptom analysis
• Healthcare Staff - Manage patient appointments and bed allocations
• Administrators - Oversee system operations and hospital management

• Email/Password registration and login
• Firebase Authentication integration
• Secure session management
• User role-based access control (Patient, Staff, Admin)

• AI-powered symptom analysis using Groq LLaMA 3.3 70B model
• Real-time health assessment recommendations
• Structured JSON output for consistent results
• Free Tier: 30 requests/minute, 14,400 requests/day

• Browse available hospitals
• View hospital details, specializations, and ratings
• Real-time bed availability tracking
• Hospital search and filtering

• Easy-to-use appointment scheduling
• View available time slots
• Appointment confirmation and tracking
• Manage active and past appointments

• Reserve hospital beds
• Check real-time bed availability
• Manage bed reservations
• Emergency bed allocation

• Personalized patient dashboard
• Quick access to health records
• Appointment and booking history
• Emergency assistance button

• One-tap emergency alerts
• Nearby hospital location
• Emergency contact integration

Before you begin, ensure you have the following installed:

• Flutter SDK (v3.9.2 or higher)

  • Download from flutter.dev
  • Run flutter --version to verify

• Dart SDK (v3.9.2 or higher) - Included with Flutter

• Android Studio or Xcode for mobile emulation/development

  • Android: SDK level 21 or higher
  • iOS: iOS 11.0 or higher

• Git for version control

• Groq API Key (Free tier)

  • Sign up at console.groq.com
  • Create an API key from the dashboard

• Firebase Project Setup

  • Create a project on Firebase Console
  • Enable Authentication (Email/Password)
  • Enable Cloud Firestore
  • Download configuration files

git clone https://github.com/asadullah098/digital-healthcare-assistance.git
cd digital-healthcare-assistance

flutter pub get

flutter pub run build_runner build

flutter doctor

Ensure all required components are installed. Fix any issues reported.

For Android:

cd android
./gradlew build
cd ..

For iOS:

cd ios
pod install
cd ..

1. Create a Firebase Project

   • Go to Firebase Console
   • Click "Create Project"
   • Follow the setup wizard

2. Configure Android

   • Download google-services.json from Firebase Console
   • Place it in android/app/
   • Ensure this file is in .gitignore for security

3. Configure iOS

   • Download GoogleService-Info.plist from Firebase Console
   • Add it to your iOS project using Xcode
   • Add to .gitignore for security

4. Enable Firebase Services

   • Authentication → Enable Email/Password provider
   • Cloud Firestore → Enable with appropriate security rules
   • Storage (Optional) → For user profile pictures

1. Get Your API Key

   # Visit https://console.groq.com/keys
   # Sign up or log in
   # Create an API key

2. Set Environment Variable

   For Development:

   flutter run --dart-define=GROQ_API_KEY=your_actual_key_here

   Using .env File (Local Development Only):

   • Create a .env file in the project root:

   GROQ_API_KEY=your_actual_key_here
   

   • Add to .gitignore:

   .env
   .env.local
   

   • Load in your app using flutter_dotenv package

lib/
├── main.dart                    # Application entry point
├── models/                      # Data models
│   ├── appointment_model.dart
│   ├── bed_booking_model.dart
│   ├── hospital_model.dart
│   ├── symptom_analysis_model.dart
│   └── user_model.dart
├── providers/                   # State management (Riverpod)
│   ├── auth_provider.dart
│   ├── booking_provider.dart
│   ├── hospital_provider.dart
│   └── symptom_provider.dart
├── screens/                     # UI Screens
│   ├── auth/                    # Authentication screens
│   ├── patient/                 # Patient-specific screens
│   ├── staff/                   # Staff management screens
│   └── admin/                   # Admin panel screens
├── services/                    # Business logic & API calls
│   ├── auth_service.dart
│   ├── grok_api_service.dart    # Groq API integration
│   └── hospital_service.dart
├── utils/                       # Utilities & constants
│   ├── app_theme.dart           # Theme configuration
│   └── constants.dart           # App constants
├── widgets/                     # Reusable UI components
│   └── dashboard_card.dart
└── firebase_options.dart        # Firebase configuration

android/                         # Android native code
ios/                            # iOS native code
test/                           # Unit and widget tests

For Development:

# Run on connected device or emulator
flutter run

# With API key
flutter run --dart-define=GROQ_API_KEY=your_key

For Release Build:

flutter build apk --release          # Android APK
flutter build appbundle --release     # Android App Bundle
flutter build ios --release           # iOS (requires macOS)

1. Patient Registration & Login

• Launch app → Register with email/password
• Firebase authenticates and creates user profile

2. Symptom Analysis

• Go to "Symptom Analysis"
• Enter your symptoms
• AI analyzes and provides health recommendations
• View results and next steps

3. Hospital Search & Booking

• Search for hospitals by name/location
• View hospital details and ratings
• Book appointments for specific dates/times
• Confirm booking and receive confirmation

4. Bed Reservation

• Check available beds
• Select bed and duration
• Complete reservation
• Track reservation status

• Riverpod: Modern state management solution for Flutter
• Providers for auth, booking, hospitals, and symptom analysis
• Reactive updates across the UI

• Firebase Firestore: Real-time database
• Firebase Authentication: Secure user management
• Groq API: AI-powered symptom analysis

• MVVM-like architecture with Riverpod
• Separation of concerns (Services, Providers, UI)
• Reusable widgets and components

• HTTP Client: For Groq API calls
• Firebase SDKs: Real-time database operations
• JSON serialization/deserialization

1. Never commit secrets to version control
2. Use environment variables for API keys
3. Enable Firestore Security Rules to restrict database access
4. Implement Firebase Authentication for user verification
5. Use HTTPS for all API communications
6. Keep dependencies updated regularly

Key dependencies used in this project:

flutter:
  sdk: flutter
flutter_riverpod: ^3.3.1          # State management
firebase_core: ^3.13.0            # Firebase core
firebase_auth: ^5.6.0             # Authentication
cloud_firestore: ^5.6.7           # Firestore database
http: ^1.6.0                      # HTTP requests
google_fonts: ^8.0.2              # Custom fonts
intl: ^0.20.2                     # Internationalization
shared_preferences: ^2.5.5        # Local storage
url_launcher: ^6.3.1              # URL handling

See pubspec.yaml for complete list.

Contributions are welcome! To contribute:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Follow Dart style guide
• Write meaningful commit messages
• Test your changes before submitting PR
• Update documentation as needed

This project is licensed under the MIT License - see the LICENSE file for details.

• Report issues on GitHub
• Include detailed description and reproduction steps

• Flutter Documentation
• Firebase Documentation
• Groq API Documentation

• GitHub: @asadullah098
• Project Issues: GitHub Issues

• Push notifications for appointments
• Prescription digital management
• Video consultation support
• Multi-language support
• Offline mode capabilities
• Payment gateway integration
• Insurance verification
• Medical records export

• Flutter - UI framework
• Firebase - Backend services
• Groq - AI API
• Riverpod - State management
• All contributors and the open-source community

Made with ❤️ for better healthcare access

Last Updated: August 2026