{"id":25820733,"url":"https://github.com/saad2134/donor-sync","last_synced_at":"2026-03-05T06:02:28.180Z","repository":{"id":279637380,"uuid":"939446602","full_name":"saad2134/donor-sync","owner":"saad2134","description":"🩸 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. 🛠","archived":false,"fork":false,"pushed_at":"2026-03-04T04:48:56.000Z","size":30589,"stargazers_count":16,"open_issues_count":10,"forks_count":6,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-04T09:48:26.617Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://donorsync.vercel.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saad2134.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-26T14:56:54.000Z","updated_at":"2026-03-04T04:48:53.000Z","dependencies_parsed_at":"2025-02-26T16:36:06.932Z","dependency_job_id":"53918f97-b9c8-4a9f-8eda-d9cba808bd3a","html_url":"https://github.com/saad2134/donor-sync","commit_stats":null,"previous_names":["saad2134/donor-sync"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/saad2134/donor-sync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2Fdonor-sync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2Fdonor-sync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2Fdonor-sync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2Fdonor-sync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saad2134","download_url":"https://codeload.github.com/saad2134/donor-sync/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saad2134%2Fdonor-sync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30111779,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T03:40:26.266Z","status":"ssl_error","status_checked_at":"2026-03-05T03:39:15.902Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2025-02-28T10:00:05.258Z","updated_at":"2026-03-05T06:02:28.167Z","avatar_url":"https://github.com/saad2134.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e 🩸 Donor Sync – Blood Bank Management System \u003c/h1\u003e\n\n\u003e \u003cp align=\"center\"\u003e\u003cstrong\u003eA 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 \u0026 organizations. 🎯\u003c/strong\u003e\u003c/p\u003e\n\n\n\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://donorsync.vercel.app/\" target=\"_blank\"\u003e\n  \u003cimg  style=\"width:350px;\" src=\"https://img.shields.io/badge/🚀_Access_the_Prototype_Here-Live-brightgreen?style=for-the-badge\u0026labelColor=ff3838\" alt=\"Access the Prototype Here\"  /\u003e\n\u003c/a\u003e\n\n![Phase](https://img.shields.io/badge/🛠️%20Phase-In%20Development-blue?style=for-the-badge)\n![Platforms](https://img.shields.io/badge/🌐%20Platforms-Web%20%7C%20Android*-28a745?style=for-the-badge)\n\n\u003c/div\u003e\n\n## ✨ Context \n\n### 🏆 Google Developer Group (GDG) on Campus Solution Challenge India 2025\n- Initially developed as a Prototype for Google Developer Group (GDG) on Campus Solution Challenge India 2025\n- Sustainable Development Goal (SDG): 3. Good health and well being.\n- 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.\n\n👥 Original Hack2innovate Team Members\n\n1. [**Fareed Ahmed Owais**](https://github.com/FareedAhmedOwais)\n2. [**Mohammed Saad Uddin**](https://github.com/saad2134)\n3. [**Abdur Rahman Qasim**](https://github.com/Abdur-rahman-01)\n4. [**Mohammed Abdul Rahman**](https://github.com/Abdul-Rahman26)\n\n## 🚀 Features\n\n- *🔗 Donor-Hospital Connection*: Directly links blood donors with hospitals for real-time donation requests.\n- *📊 Database Management*: Stores and manages detailed information on blood donors, hospitals, and active donor organizations.\n- *📈 Donation Tracking*: Tracks blood donation records and availability, ensuring transparency and faster access.\n- *🔒 User Access*: Secure access for hospitals, donors, and partner organizations.\n- *⚡ Efficiency*: Reduces delays in emergency cases through an automated system.\n\n## 📊 Usage\n\n1. *Patients*: Register and request for specific blood types.\n2. *Donors*: Register and find places where blood is needed.\n3. *Hospitals*: Request blood directly from registered donors.\n4. *Organizations*: Manage donation drives and support patients.\n\n---\n\n## ⚙️ Platforms\n\n| Platform                                                       | Supported? |\n| --------------------------------------------------------------- | ----------- |\n| Web (any browser with JS functionality) + Fully Responsive       | ✅          |\n| [Android](frontend-android/) (non-natively through WebView)                | ✅          |\n\n## 🛠 Tech Stack *\n\n```mermaid\nflowchart LR\n    %% Frontend\n    subgraph Frontend\n        FE[React + Next.js\u003cbr\u003eTypeScript + TailwindCSS\u003cbr\u003eshadcn/ui + AceternityUI\u003cbr\u003e\n        Vercel Hosting\u003cbr\u003e\n        Developed in \n        Firebase Studio IDE]\n         \n    end\n\n    %% Backend Services\n    subgraph Backend_Services[\"Backend Services\"]\n        VERIFY[Phone Email\u003cbr\u003eEmail \u0026 Phone Verification]\n        STORAGE[Uploadcare\u003cbr\u003eFile Storage]\n        DB[Firestore\u003cbr\u003eNoSQL Database]\n        FEEDBACK[Google Apps Script\u003cbr\u003eFeedback Collection]\n        BOT[Gemini API\u003cbr\u003eSyncbot Chatbot]\n  \n    end\n\n    %% Connections\n    FE \u003c--\u003e VERIFY\n    FE \u003c--\u003e STORAGE\n    FE \u003c--\u003e DB\n    FE \u003c--\u003e BOT\n    FE \u003c--\u003e FEEDBACK\n\n\n```\n\n## 🚀 Getting Started *\n\n### Web Frontend: Install \u0026 Run the Project \n\n1. Clone \u0026 Download the Repo\n\n2. Install NodeJS on your system.\n\n3. Open the project in your preferred IDE.\n\n4. Run in Terminal to Install all dependancies:\n   ```bash\n   npm i\n   ```\n\n4. Get all api keys in env.template as set them in your env:\n\n5. Run in Terminal to Start Development Server:\n   ```bash\n   npm run dev\n   ```\n\n### Web Frontend: Using the app\n1. Simply go to https://donorsync.vercel.app/\n\n### Android Frontend: Using the app\n1. Enable `Install from Unknown Sources` in your android device settings.\n2. Download the latest `.apk` file from the [`native`](native/) directory and install it on your device.\n\n\n\n## 📁 Project Architecture\n```\ndonor-sync/\n└── README.md \u0026 LICENSE etc.\n└── frontend-web/\n    ├── app/\n    │   └── …                     # Top-level Next.js app directory (routes, layouts, pages, etc.)\n    ├── components/\n    │   └── …                     # Reusable UI components (buttons, forms, cards, etc.)\n    ├── context/\n    │   └── …                     # React Contexts for state management across components\n    ├── data/\n    │   └── …                     # Static data, seed data, or JSON fixtures used in the app\n    ├── hooks/\n    │   └── …                     # Custom React hooks (e.g. for fetching, authentication, etc.)\n    ├── lib/\n    │   └── …                     # Library code: utilities, helper functions, wrappers over APIs\n    ├── public/\n    │   └── …                     # Static assets (images, icons, fonts, etc.)\n    ├── types/\n    │   └── …                     # TypeScript type definitions and interfaces\n    ├── firebaseConfig.ts          # Firebase setup / initialization logic\n    ├── firebaseFunctions.ts       # Cloud Functions or server-side Firebase logic\n    ├── next.config.ts             # Next.js configuration\n    ├── tailwind.config.ts         # Tailwind CSS configuration\n    ├── tsconfig.json              # TypeScript configuration\n    ├── env.template               # Template for environment variables (API keys, etc.)\n    ├── firebase.json              # Firebase project settings, rules, etc.\n    ├── database.rules.json        # Firestore database rules\n    ├── package.json               # Project dependencies \u0026 scripts\n    ├── eslint.config.mjs          # Linting rules\n```\n\n## 📱 Screenshots\n\n\u003ctable\u003e \u003ctr\u003e \u003ctd\u003e\u003cstrong\u003eLanding Page\u003c/strong\u003e\u003cbr\u003e\u003cbr\u003e \u003cimg src=\"https://github.com/user-attachments/assets/4c4d534c-c6f3-4049-a0bb-ace850f0d1ba\" width=\"100%\" alt=\"Landing Page\" /\u003e \u003c/td\u003e \u003c/tr\u003e \u003ctr\u003e \u003ctd\u003e\u003cstrong\u003eAuthentication\u003c/strong\u003e\u003cbr\u003e\u003cbr\u003e \u003cimg src=\"https://github.com/user-attachments/assets/cc9c6a2b-1e15-4fdc-8ade-813c71853d50\" width=\"300px\" alt=\"Authentication\" /\u003e \u003c/td\u003e \u003c/tr\u003e \u003ctr\u003e \u003ctd\u003e\u003cstrong\u003eDonor Blood Donation Search\u003c/strong\u003e\u003cbr\u003e\u003cbr\u003e \u003cimg src=\"https://github.com/user-attachments/assets/5ba4b049-67a1-483a-b219-d11e7b037d8f\" width=\"100%\" alt=\"Donor Blood Donation Search\" /\u003e \u003c/td\u003e \u003c/tr\u003e \u003ctr\u003e \u003ctd\u003e\u003cstrong\u003eDonor Profile\u003c/strong\u003e\u003cbr\u003e\u003cbr\u003e \u003cimg src=\"https://github.com/user-attachments/assets/1f09e451-d409-4ba5-aaf0-d6d7291f365f\" width=\"100%\" alt=\"Donor Profile\" /\u003e \u003c/td\u003e \u003c/tr\u003e \u003ctr\u003e \u003ctd\u003e\u003cstrong\u003eSettings\u003c/strong\u003e\u003cbr\u003e\u003cbr\u003e \u003cimg src=\"https://github.com/user-attachments/assets/777be84e-23ff-4d86-a4f0-18f5cbae6978\" width=\"100%\" alt=\"Settings\" /\u003e \u003c/td\u003e \u003c/tr\u003e \u003ctr\u003e \u003ctd\u003e\u003cstrong\u003eCommunity\u003c/strong\u003e\u003cbr\u003e\u003cbr\u003e \u003cimg src=\"https://github.com/user-attachments/assets/99f36774-a22a-4f5b-b573-a582f020e1e8\" width=\"100%\" alt=\"Community\" /\u003e \u003c/td\u003e \u003c/tr\u003e \u003ctr\u003e \u003ctd\u003e\u003cstrong\u003eSyncbot AI Chatbot\u003c/strong\u003e\u003cbr\u003e\u003cbr\u003e \u003cimg src=\"https://github.com/user-attachments/assets/a83f5337-f572-4ce8-a987-8847f2ed7d4a\" width=\"100%\" alt=\"Syncbot AI Chatbot\" /\u003e \u003c/td\u003e \u003c/tr\u003e \u003c/table\u003e\n\n## 📊 **Project Stats**\n\n\u003cdiv align=\"center\"\u003e\n  \n![Repo Size](https://img.shields.io/github/repo-size/saad2134/donor-sync)\n![Last Commit](https://img.shields.io/github/last-commit/saad2134/donor-sync)\n![Open Issues](https://img.shields.io/github/issues/saad2134/donor-sync)\n![Open PRs](https://img.shields.io/github/issues-pr/saad2134/donor-sync)\n![License](https://img.shields.io/github/license/saad2134/donor-sync)\n![Forks](https://img.shields.io/github/forks/saad2134/donor-sync?style=social)\n![Stars](https://img.shields.io/github/stars/saad2134/donor-sync?style=social)\n![Watchers](https://img.shields.io/github/watchers/saad2134/donor-sync?style=social)\n![Contributors](https://img.shields.io/github/contributors/saad2134/donor-sync)\n![Languages](https://img.shields.io/github/languages/count/saad2134/donor-sync)\n![Top Language](https://img.shields.io/github/languages/top/saad2134/donor-sync)\n\n\u003c/div\u003e\n\n## ⭐ Star History\n\n\u003ca href=\"https://www.star-history.com/#saad2134/donor-sync\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=saad2134/donor-sync\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=saad2134/donor-sync\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=saad2134/donor-sync\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n## ✨ Icon\n\n\u003cimg src=\"https://github.com/user-attachments/assets/01f9e3d6-85a7-4d97-9348-1fc046ea2ff2\" alt=\"icon\" width=\"250\"/\u003e\n\n## 🔰 Banner\n\n![repository-open-graph](https://github.com/user-attachments/assets/13f5c0fd-96ff-4275-a634-4cd1efc79b52)\n\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n- ✅ Commercial use\n- ✅ Modification\n- ✅ Distribution\n- ✅ Private use\n- ❌ Liability\n- ❌ Warranty\n\n---\n\n## ✍️ Endnote\n\u003cp align=\"center\"\u003eInitially developed with 💖 as a Prototype for Google Developer Group (GDG) on Campus Solution Challenge India 2025\u003c/p\u003e\n\u003cp align=\"center\"\u003e⭐ Star this repo if you found it helpful! Thanks for reading.\u003c/p\u003e\n\n---\n\n## 🏷 Tags\n\n`#BloodBank` `#HealthcareTech` `#DatabaseManagement` `#WebApp` `#GBGChallenge` `#MedicalInnovation` `#BloodDonation` `#DonorManagement` `#HospitalManagement` `#FullStackDevelopment` `#HealthTech` `#EmergencyServices` `#DataManagement` `#CommunitySupport` `#HealthcareAccess` `#OpenSource` `#HealthcareInnovation` `#AIforSocialGood` `#BuildWithAI`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaad2134%2Fdonor-sync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaad2134%2Fdonor-sync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaad2134%2Fdonor-sync/lists"}