PlasmaX — Plasma Bank & Donor Management System

PlasmaX is a cross-platform Plasma Bank and Donor Management System built with Flutter. It bridges the gap between plasma donors, patients, and healthcare institutions by providing streamlined donor registration, real-time intake requests, interactive hospital locator mapping, administrative verification workflows, and an integrated AI medical assistant.

---

🚀 Live Demo & Deployment

• Live Web Application & PWA: https://plasmax-app.vercel.app/
• GitHub Repository: https://github.com/veenothay078-sys/plasmax

---

✨ Features

• Donor Onboarding & Management: Complete donor profile creation with blood group selection, contact details, medical eligibility screening, and operational availability.
• Receiver & Hospital Intake: Structured intake workflows for patients needing emergency plasma and hospitals submitting institutional requests.
• Interactive Map & Facility Locator: Real-time geolocation-based hospital and blood bank mapping using OpenStreetMap and GPS positioning.
• Plasma Request Tracking: Direct plasma requests with priority indicators, blood type compatibility filtering, and history logs.
• Admin Verification Panel: Secure admin dashboard for reviewing and approving donor and receiver registrations.
• AI Plasma Assistant: Built-in AI chat module for answering FAQs regarding plasma donation criteria and medical guidelines.
• Multilingual Support: Localized in English, Hindi, and Spanish.
• Dark & Light Mode: Seamless theme switching with high-contrast accessibility.
• Progressive Web App (PWA): Installable on Android (via Chrome) and iOS (via Safari) with standalone app experience.

---

🛠️ Tech Stack

• Frontend / Framework: Flutter (Channel stable, 3.29.2), Dart (3.7.2)
• Backend & Database: Firebase Firestore, Firebase Authentication, Firebase Storage, Firebase Cloud Messaging (FCM)
• Mapping & Geolocation: geolocator, flutter_map, latlong2, OpenStreetMap
• State & Storage: shared_preferences, Material 3 Design
• Supported Platforms:
  • 🌐 Web / Progressive Web App (PWA)
  • 📱 Android (APK / AAB)
  • 🍏 iOS (iPhone / iPad)

---

💻 Getting Started Locally

Prerequisites

• Flutter SDK (v3.20+ recommended)
• Dart SDK (v3.6+)
• Chrome (for web debugging) or Android Studio / Xcode (for mobile builds)

Installation

1. Clone the repository:

   git clone https://github.com/veenothay078-sys/plasmax.git
   cd plasmax

2. Install dependencies:

   flutter pub get

3. Run the application:

   # Run in Chrome (Web)
   flutter run -d chrome
   
   # Run on connected mobile device
   flutter run

---

📦 Building for Production

Web Build

flutter build web --release

The compiled output will be generated inside the build/web directory.

Android Build

flutter build apk --release

The release APK will be generated at build/app/outputs/flutter-apk/app-release.apk.

---

🌐 Web Deployment (Vercel)

PlasmaX is configured to deploy directly to Vercel with SPA routing and PWA caching headers:

• Build Command: flutter build web
• Output Directory: build/web
• Configuration: Handled via vercel.json with single-page app rewrites to /index.html.

---

📲 PWA Installation Guide

PlasmaX can be installed directly onto your mobile home screen without requiring an app store download:

On Android (Chrome)

1. Open https://plasmax-app.vercel.app/ in Google Chrome.
2. Tap the three-dot menu in the top-right corner.
3. Select Install app or Add to Home screen.
4. The PlasmaX icon will appear on your home screen and launch in standalone mode.

On iOS (Safari)

1. Open https://plasmax-app.vercel.app/ in Safari.
2. Tap the Share icon at the bottom of the screen.
3. Scroll down and tap Add to Home Screen.
4. Tap Add in the top-right corner. PlasmaX will launch full-screen as a standalone application.

---

📄 License

This project is licensed under the MIT License.