Skip to content

shady-2004/DonorGo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

304 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🩸 DonorGo – Egypt’s Smart Blood Donation Platform

Saving lives through technology.
DonorGo connects blood donors with hospitals in real-time to ensure no life is lost due to blood shortage.


🚨 The Problem

In Egypt, less than 1% of the population donates blood — far below the global average of 3%.
This critical shortage puts thousands of lives at risk every year, especially during emergencies when hospitals struggle to find suitable donors quickly.


💡 Our Mission

DonorGo was built to bridge this life-threatening gap.
Our goal is to increase Egypt’s donation rate to 3%+, creating a reliable, nationwide network that connects willing donors with hospitals in need — efficiently, safely, and in real time.


🏥 How It Works

  1. Hospitals post blood donation requests through their dedicated dashboard.
  2. Donors receive alerts and can instantly apply to ongoing requests that match their blood type.
  3. Admins oversee the system, verifying hospitals, managing operations, and ensuring integrity.
  4. Smart notifications & verification keep both sides informed and secure.

🔐 Key Features

👥 User Roles

  • Donor: Register, verify email, complete profile, and apply to donation requests.
  • Hospital: Post blood requests, manage active donations, and communicate with donors.
  • Admin Portal: Monitor users, verify hospitals, and manage platform data.

⚙️ Core Functionalities

  • 🧾 Donation Request System – Hospitals can create and manage requests in real-time.
  • 📬 Email Notifications – Automated updates for critical operations (e.g., new requests, approvals).
  • Authentication & Security – Email verification, password recovery, and role-based access.
  • 🧠 User Info Validation – Donors must complete vital medical and contact information.
  • 📊 Admin Control Panel – Manage users, hospitals, and data across the system.

🧠 Tech Stack

Frontend

Backend


🧩 System Overview

 DonorGo Platform
│
├── 👤 Donor Portal
│ ├── Register / Login / Verify Email
│ ├── View & Apply to Hospital Requests
│ └── Manage Profile & Donation History
│
├── 🏥 Hospital Dashboard
│ ├── Create Blood Requests
│ ├── Manage Active Donations
│ └── View Donor Applications
│
└── 🧭 Admin Panel
├── Manage Users & Hospitals
├── Verify New Hospitals
└── System Analytics

🎥 Demo Video

👩‍⚕️ For Hospitals

See how hospitals can create requests and connect with nearby donors instantly.

🩸 For Donors

Experience how donors register, verify, and apply to save lives.

📺 Watch the full demo here:
➡️ [Demo Video Link Placeholder]


🚀 Getting Started (Developers)

# Clone the repository
git clone https://github.com/yourusername/DonorGo.git
cd DonorGo

# Install dependencies
npm install

# Run frontend and backend
cd frontend && npm run dev
cd ../backend && npm run dev

💌 Contact & Collaboration

Want to collaborate or onboard your hospital? 📧 Contact us: donorgo25@gmail.com

🌐 Website: [https://donor-go-hazel.vercel.app/]

🧪 Project Status

🚧 This project is still under active development. If you encounter any bugs, have feature suggestions, or innovative ideas to improve DonorGo, please reach out to us at: 📩 donorgo25@gmail.com

Made by love ❤️ to Egypt and whole world

👨‍💻 Contributors

Amr Hany Shady Mohamed
Amr Hany – Frontend Developer Shady Mohamed – Backend Developer

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages