🩸 Donor Sync (Blood Bank Management System)

A comprehensive web-based and webapp 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 and Organizations. 🎯

✨ Context

💡 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
2. Mohammed Saad Uddin
3. Abdur Rahman Qasim
4. Mohammed Abdul Rahman

🚀 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 (non-natively through WebView)	✅

🛠 Tech Stack *

• React + NextJS + TailwindCSS + TypeScript
• shadcn/ui & AceternityUI for UI components
• Phone Email for Email & Phone Verification
• Uploadcare for File Storage
• Database Management System - Firestore NoSQL Database
• Vercel for Hosting
• Firebase Studio (formerly Project IDX) as a IDE

🚀 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:

   npm i

5. Get all api keys in env.template as set them in your env:

6. Run in Terminal to Start Development Server:

   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 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 file for details.

• ✅ Commercial use
• ✅ Modification
• ✅ Distribution
• ✅ Private use
• ❌ Liability
• ❌ Warranty

---

✍️ Endnote

Developed with 💖 for the GDG on Campus Solution Challenge India 2025, with heartfelt thanks to Google & Hack2skill for the opportunity to build and innovate.

---

🏷 Tags

#BloodBank #HealthcareTech #DatabaseManagement #WebApp #GBGChallenge #MedicalInnovation #BloodDonation #DonorManagement #HospitalManagement #FullStackDevelopment #HealthTech #EmergencyServices #DataManagement #CommunitySupport #HealthcareAccess #OpenSource #HealthcareInnovation #AIforSocialGood #BuildWithAI