Blood Donor Finder is a mobile application that bridges the critical gap between blood donors and recipients. In emergency situations, finding the right blood group quickly can be the difference between life and death. This app enables anyone to find verified blood donors nearby by blood group and city, and also lets willing donors register themselves to help others.
Built as a Third Year Mobile Application Lab Project at Poornima Institute of Engineering & Technology, Jaipur (Academic Year 2025–26).
| Feature | Description |
|---|---|
| 🔍 Smart Search | Search donors by blood group (A+, A−, B+, B−, O+, O−, AB+, AB−) |
| 🏙️ City Filter | Filter donors by city for nearby results |
| 📋 Donor Profiles | View donor details — name, age, blood group, city |
| 📞 One-Tap Call | Call a donor directly from the app |
| 💬 WhatsApp Message | Message donors via WhatsApp instantly |
| ✍️ Donor Registration | Register as a donor with name, age, phone, city & blood group |
| ✅ Availability Status | Donors can mark themselves as available to donate |
| 🔥 Firebase Backend | Real-time data sync powered by Firebase Firestore |
| 📊 Donor Stats | See total donors, cities listed, and available donors |
| Splash Screen | Donor List | Donor Detail | Contact |
|---|---|---|---|
| App launches with branding | Browse & filter donors | Full donor info | Call or WhatsApp |
Screenshots show the live app with real donor data from Jaipur.
App Opens
│
├── PATH 1: Find a Donor
│ └── Home Screen (select blood group + city)
│ └── Apply Filters
│ └── Donor List Screen
│ └── Select Donor
│ └── Donor Detail Screen
│ ├── 📞 Call Button
│ └── 💬 WhatsApp Button
│
└── PATH 2: Register as Donor
└── Register Form Screen (Name, Age, Phone, City, Blood Group)
└── Submit → Validation
├── Invalid Data → Re-enter
└── Valid Data → Save to Firebase → ✅ Success
- Frontend: Flutter (Dart)
- Backend / Database: Firebase Firestore
- Authentication: Firebase Auth
- Communication: Android Intent API (Call & WhatsApp)
- Platform: Android
- Flutter SDK (≥ 3.0)
- Android Studio / VS Code
- A Firebase project with Firestore enabled
# 1. Clone the repository
git clone https://github.com/Arpitgarg07/BloodDonorApp.git
# 2. Navigate to project directory
cd BloodDonorApp
# 3. Install dependencies
flutter pub get
# 4. Connect your Firebase project
# Add your google-services.json in android/app/
# 5. Run the app
flutter run- Go to Firebase Console
- Create a new project
- Enable Cloud Firestore in your project
- Download
google-services.jsonand place it insideandroid/app/ - Set Firestore rules to allow read/write during development:
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
match /{document=**} {
allow read, write: if true;
}
}
}
⚠️ Update rules before production deployment.
BloodDonorApp/
├── lib/
│ ├── main.dart # Entry point
│ ├── screens/
│ │ ├── home_screen.dart # Donor search & filter
│ │ ├── donor_list_screen.dart # List of matching donors
│ │ ├── donor_detail_screen.dart # Donor profile & contact
│ │ └── register_screen.dart # Donor registration form
│ ├── models/
│ │ └── donor.dart # Donor data model
│ └── services/
│ └── firebase_service.dart # Firestore operations
├── android/
│ └── app/
│ └── google-services.json # Firebase config
└── pubspec.yaml
Each donor document in Firestore has the following structure:
{
"name": "Arpit Garg",
"age": 19,
"phone": "8377181470",
"city": "Jaipur",
"bloodGroup": "B+",
"availableToDonate": true
}- Donor registration with Firebase
- Search & filter by blood group and city
- Call & WhatsApp integration
- Donor availability toggle
- Push notifications for urgent blood requests
- Location-based donor discovery (GPS)
- Donor history & donation tracking
- iOS support
Arpit Garg
- 🎓 PIET23CS025 — Department of Computer Engineering
- 🏫 Poornima Institute of Engineering & Technology, Jaipur
Made with ❤️ and 🩸 in Jaipur, Rajasthan