https://github.com/saad2134/donor-sync
🩸 Donor Sync – A web-based platform that directly connects blood donors with hospitals, and links hospitals to patients and NGOs, enabling faster, more efficient blood donation. Originally built as a prototype for the GDSC Solution Challenge 2025, addressing the problem of limited healthcare access in underserved communities. 🛠
https://github.com/saad2134/donor-sync
aiforsocialgood blood-bank blood-donation blood-donation-app blood-donation-management blood-management-system buildwithai donor-management emergency-services fullstack-development gdg-challenge health-tech healthcare-access healthcare-innovation healthcare-tech medical-innovation solutionchallenge2025 solvewithai
Last synced: 23 days ago
JSON representation
🩸 Donor Sync – A web-based platform that directly connects blood donors with hospitals, and links hospitals to patients and NGOs, enabling faster, more efficient blood donation. Originally built as a prototype for the GDSC Solution Challenge 2025, addressing the problem of limited healthcare access in underserved communities. 🛠
- Host: GitHub
- URL: https://github.com/saad2134/donor-sync
- Owner: saad2134
- License: mit
- Created: 2025-02-26T14:56:54.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-04T04:48:56.000Z (24 days ago)
- Last Synced: 2026-03-04T09:48:26.617Z (23 days ago)
- Topics: aiforsocialgood, blood-bank, blood-donation, blood-donation-app, blood-donation-management, blood-management-system, buildwithai, donor-management, emergency-services, fullstack-development, gdg-challenge, health-tech, healthcare-access, healthcare-innovation, healthcare-tech, medical-innovation, solutionchallenge2025, solvewithai
- Language: TypeScript
- Homepage: https://donorsync.vercel.app/
- Size: 29.2 MB
- Stars: 16
- Watchers: 0
- Forks: 6
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
🩸 Donor Sync – Blood Bank Management System
>
A comprehensive web-based platform that connects blood donors directly with hospitals, ensuring quick and efficient blood donation. It manages databases for donors, hospitals, and active donor organizations, streamlining the process and improving healthcare accessibility, with seamless connectivity between donors, patients, hospitals & organizations. 🎯
## ✨ Context
### 🏆 Google Developer Group (GDG) on Campus Solution Challenge India 2025
- Initially developed as a Prototype for Google Developer Group (GDG) on Campus Solution Challenge India 2025
- Sustainable Development Goal (SDG): 3. Good health and well being.
- Problem Statement: "Lack of Access to Healthcare in Underserved Communities". Many communities, especially in rural and remote areas, lack access to basic healthcare services. This results in poor health outcomes, preventable diseases, and reduced quality of life. Barriers include inadequate healthcare infrastructure, a shortage of medical professionals, and limited awareness of preventive care.
👥 Original Hack2innovate Team Members
1. [**Fareed Ahmed Owais**](https://github.com/FareedAhmedOwais)
2. [**Mohammed Saad Uddin**](https://github.com/saad2134)
3. [**Abdur Rahman Qasim**](https://github.com/Abdur-rahman-01)
4. [**Mohammed Abdul Rahman**](https://github.com/Abdul-Rahman26)
## 🚀 Features
- *🔗 Donor-Hospital Connection*: Directly links blood donors with hospitals for real-time donation requests.
- *📊 Database Management*: Stores and manages detailed information on blood donors, hospitals, and active donor organizations.
- *📈 Donation Tracking*: Tracks blood donation records and availability, ensuring transparency and faster access.
- *🔒 User Access*: Secure access for hospitals, donors, and partner organizations.
- *⚡ Efficiency*: Reduces delays in emergency cases through an automated system.
## 📊 Usage
1. *Patients*: Register and request for specific blood types.
2. *Donors*: Register and find places where blood is needed.
3. *Hospitals*: Request blood directly from registered donors.
4. *Organizations*: Manage donation drives and support patients.
---
## ⚙️ Platforms
| Platform | Supported? |
| --------------------------------------------------------------- | ----------- |
| Web (any browser with JS functionality) + Fully Responsive | ✅ |
| [Android](frontend-android/) (non-natively through WebView) | ✅ |
## 🛠 Tech Stack *
```mermaid
flowchart LR
%% Frontend
subgraph Frontend
FE[React + Next.js
TypeScript + TailwindCSS
shadcn/ui + AceternityUI
Vercel Hosting
Developed in
Firebase Studio IDE]
end
%% Backend Services
subgraph Backend_Services["Backend Services"]
VERIFY[Phone Email
Email & Phone Verification]
STORAGE[Uploadcare
File Storage]
DB[Firestore
NoSQL Database]
FEEDBACK[Google Apps Script
Feedback Collection]
BOT[Gemini API
Syncbot Chatbot]
end
%% Connections
FE <--> VERIFY
FE <--> STORAGE
FE <--> DB
FE <--> BOT
FE <--> FEEDBACK
```
## 🚀 Getting Started *
### Web Frontend: Install & Run the Project
1. Clone & Download the Repo
2. Install NodeJS on your system.
3. Open the project in your preferred IDE.
4. Run in Terminal to Install all dependancies:
```bash
npm i
```
4. Get all api keys in env.template as set them in your env:
5. Run in Terminal to Start Development Server:
```bash
npm run dev
```
### Web Frontend: Using the app
1. Simply go to https://donorsync.vercel.app/
### Android Frontend: Using the app
1. Enable `Install from Unknown Sources` in your android device settings.
2. Download the latest `.apk` file from the [`native`](native/) directory and install it on your device.
## 📁 Project Architecture
```
donor-sync/
└── README.md & LICENSE etc.
└── frontend-web/
├── app/
│ └── … # Top-level Next.js app directory (routes, layouts, pages, etc.)
├── components/
│ └── … # Reusable UI components (buttons, forms, cards, etc.)
├── context/
│ └── … # React Contexts for state management across components
├── data/
│ └── … # Static data, seed data, or JSON fixtures used in the app
├── hooks/
│ └── … # Custom React hooks (e.g. for fetching, authentication, etc.)
├── lib/
│ └── … # Library code: utilities, helper functions, wrappers over APIs
├── public/
│ └── … # Static assets (images, icons, fonts, etc.)
├── types/
│ └── … # TypeScript type definitions and interfaces
├── firebaseConfig.ts # Firebase setup / initialization logic
├── firebaseFunctions.ts # Cloud Functions or server-side Firebase logic
├── next.config.ts # Next.js configuration
├── tailwind.config.ts # Tailwind CSS configuration
├── tsconfig.json # TypeScript configuration
├── env.template # Template for environment variables (API keys, etc.)
├── firebase.json # Firebase project settings, rules, etc.
├── database.rules.json # Firestore database rules
├── package.json # Project dependencies & scripts
├── eslint.config.mjs # Linting rules
```
## 📱 Screenshots
Landing Page
Authentication
Donor Blood Donation Search
Donor Profile
Settings
Community
Syncbot AI Chatbot
## 📊 **Project Stats**
## ⭐ Star History
## ✨ Icon
## 🔰 Banner
## 📄 License
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
- ✅ Commercial use
- ✅ Modification
- ✅ Distribution
- ✅ Private use
- ❌ Liability
- ❌ Warranty
---
## ✍️ Endnote
Initially developed with 💖 as a Prototype for Google Developer Group (GDG) on Campus Solution Challenge India 2025
⭐ Star this repo if you found it helpful! Thanks for reading.
---
## 🏷 Tags
`#BloodBank` `#HealthcareTech` `#DatabaseManagement` `#WebApp` `#GBGChallenge` `#MedicalInnovation` `#BloodDonation` `#DonorManagement` `#HospitalManagement` `#FullStackDevelopment` `#HealthTech` `#EmergencyServices` `#DataManagement` `#CommunitySupport` `#HealthcareAccess` `#OpenSource` `#HealthcareInnovation` `#AIforSocialGood` `#BuildWithAI`