🩸 Introduction

BloodConnection is an AI-powered, full-stack web application designed to bridge the gap between blood donors and recipients. With real-time inventory management, emergency response, and intelligent donor-matching systems, the platform empowers hospitals, volunteers, and individuals to facilitate life-saving blood donations quickly and efficiently.

🔍 Why BloodConnection?

Despite advancements in healthcare, many lives are lost due to the unavailability of blood at critical moments. Traditional blood bank systems often suffer from delayed communication, unstructured data, and lack of real-time insights.

BloodConnection addresses these challenges by:

• Streamlining donor-recipient communication
• Enabling real-time blood stock visibility
• Automating donor matching and health eligibility analysis
• Offering geo-based blood request handling
• Supporting emergency broadcasts and mobile unit dispatch

⚙️ Key Features (At a Glance)

• 🔐 Role-Based Dashboards – Dedicated portals for Admins, Donors, Hospitals, Lab Technicians, and Volunteers
• 📦 Inventory Management – Track blood units by group, quantity, expiry date, and availability status
• 📍 Location-Based Search – Discover nearby donors and hospitals with Google Maps integration
• 🧠 AI Medical Assistant – Upload and analyze reports to check donor eligibility instantly
• 🚨 Emergency Request Handling – Broadcast alerts to 500+ donors, with an average 12-minute response time
• 🤖 AI Chatbot – 24/7 intelligent assistant for queries, donor guidance, and report handling
• 📊 Data Dashboard – Live statistics, city-wise blood data, and demand forecasting
• 🔄 Smart Donor Matching – Automatic matching based on blood type and proximity
• 🔒 Secure Auth & Encryption – Email/OTP login, JWT auth, and data protection with encryption
• 📬 Direct Contact Options – Instantly email or call matched donors in real-time

🚀 Getting Started

🔧 Prerequisites

• Node.js (v14 or above)
• npm
• Git

📦 Installation

1. Clone the repository:

   git clone https://github.com/ShubhamxGupta/BloodConnection.git
   cd BloodConnection

2. Install dependencies:

   cd frontend
   npm install
   cd backend
   npm install

▶️ Running Locally

1. Start backend server:

   cd backend
   node server.js

2. Start frontend server (in a new terminal):

   cd frontend
   npm run dev

3. Open your browser at: http://localhost:5173

Contact

Developed by Shubham Gupta, Abhay Tiwari, Prayasha Nanda and Mohita.

Feel free to reach out via GitHub or email.