KanVer is a mobile application that connects blood donors with those in need. The app allows users to create blood donation requests, find suitable donors, and receive location-based notifications.
📱 Platform: Flutter (iOS & Android)
🌐 Backend: Flask (Python)
☁️ Database: MySQL on AWS
🔑 Authentication: Firebase
Home Screen Personalized homepage of the application showing open requests. |
Request Details Request details and the location of the hospital on Google Maps. |
My Requests "My Requests" page showing the requests the user has donated or created. |
Create Request "Add Request" page, hospital names are taken from Google Maps API with City and District values. |
- User Registration & Login: Firebase Authentication-based login system.
- Create Blood Donation Requests: Users can create blood donation requests based on their needs.
- Blood Type Matching: The system matches users with compatible blood donors.
- Map Integration: Displays nearby hospitals and donation points using Google Maps API.
- Proximity-Based Notifications: Users receive email notifications based on their location.
- Donation Tracking: Users can track their past donations and requests.
- Admin Panel: A ReactJS-based panel for administrators to manage requests.
| Component | Technology |
|---|---|
| Mobile Application | Flutter |
| API Usage | Google Maps API, TC ID Verification API |
| Notification System | Brevo Mail API |
| Database | MySQL (AWS) |
| Backend | Flask (Python) |
| Server Hosting | Google Cloud |
| Admin Panel | ReactJS |
| Authentication | Firebase Authentication |
- Flutter SDK (
>=3.5.4) - Firebase account
-
Clone the repository:
git clone https://github.com/CoderBees-ITU/KanVer-Frontend.git
cd KanVer-Frontend -
Install dependencies:
flutter pub get -
Configure Firebase:
- Download the
google-services.jsonfile from the Firebase Console and place it inandroid/app/. - Download the
GoogleService-Info.plistfile from the Firebase Console and place it inios/Runner/.
- Download the
-
Set the Backend API URL:
- Update the
API_URLvariable inlib/utils/constants.dartwith the backend URL.
- Update the
-
Run the application:
flutter run
Here are the related repositories for different components of the KanVer project:
| Repository | Description |
|---|---|
| KanVer Admin Panel (Frontend) | ReactJS-based admin panel for managing blood donation requests. |
| KanVer UI/UX Design | UI/UX design files and prototypes for the mobile and web applications. |
| KanVer Mail Template | Predefined email templates used for notifications in the KanVer system. |
| KanVer Backend | Flask-based backend handling API requests, authentication, and database operations. |
| Name | Role | |
|---|---|---|
| Nurefşan Altın | Mobile Developer | altinn21@itu.edu.tr |
| Bünyamin Korkut | Mobile & Backend Developer | krktbunyamin@gmail.com |
| Mehmetcan Kul | Backend Developer & Mail Notification Integration Specialist | kul21@itu.edu.tr |
| Mustafa Yunus Diler | Backend Developer & Testing Engineer | diler21@itu.edu.tr |
| Samet Birol | UI/UX Designer, DevOps & Testing Engineer | birol21@itu.edu.tr |
| Ege Keklikçi | Backend & Web Frontend Developer, Database Manager | keklikci23@itu.edu.tr |
| Mehmet Onur Şahin | Backend Developer | sahinme21@itu.edu.tr |
🎯 KanVer - One Step Closer to Saving Lives! 🚀