Skip to content

BloodBanker is an online platform designed to connect blood donors and recipients, enabling seamless and efficient blood donation management. It allows users to register as donors, browse available donation campaigns, and get in touch with nearby blood banks or individuals in need.

Notifications You must be signed in to change notification settings

istiak19/BloodBanker-client

Repository files navigation

🩸 BloodBanker

BloodBanker is an online platform designed to connect blood donors and recipients, enabling seamless and efficient blood donation management. It allows users to register as donors, browse available donation campaigns, and get in touch with nearby blood banks or individuals in need. The platform also offers features like user profiles, donation tracking, and volunteer opportunities. By making blood donation more accessible, organized, and impactful for communities, BloodBanker not only saves lives but also fosters a spirit of community support, encourages volunteerism, and strengthens social responsibility across society.

🔗 Live Website: BloodBanker


📌 Key Features

  • User Roles: Manage donor, volunteer, and admin access securely.
  • Donation Management: Schedule and track blood donations effortlessly.
  • Localized Search: Find donors and recipients by district and upazila.
  • Secure Authentication: Safeguard user data with JWT authentication.
  • Admin Dashboard: Monitor real-time user and donation statistics.
  • Blog Section: Publish updates, health tips, and inspiring stories.
  • Donation Tracking: Keep donation statuses updated and transparent
  • Payment Integration: Enable Stripe-powered donations for campaigns.
  • Responsive Design: Enjoy a smooth experience on any device.
  • Community Impact: Organize events and promote blood donation awareness.

📜 Table of Contents


🛠 Tech Stack

Frontend:

  • React (with React Router & React Query)
  • Tailwind CSS & DaisyUI
  • Firebase (Authentication & Database)
  • Stripe (Payment Processing)

📦 Dependencies

Key dependencies:

  • Frontend: React, React Router, Tailwind CSS
  • State management: React Query
  • Authentication: Firebase
  • Payment processing: Stripe
  • Forms & validation: React Hook Form
  • UI components: DaisyUI, SweetAlert2
  • SEO: React Helmet Async

🔹 Full dependency list available in package.json.


📥 Installation

1️⃣ Clone the repository:

git clone https://github.com/istiak19/BloodBanker-client
cd BloodBanker-client

2️⃣ Install dependencies:

npm install

3️⃣ Start the development server:

npm run dev

🎯 Usage Guide

  • Donors → Register, track donations, and find nearby recipients.
  • Recipients → Search for donors and request blood.
  • Admins → Manage users, oversee donation campaigns, and update the blog.

💡 Make sure to configure Firebase and Stripe API keys in the .env file before running the app.


🔧 Configuration

  • Firebase Setup → Add Firebase credentials in firebaseConfig.js.
  • Stripe Payment → Configure Stripe API keys in .env.

🚀 Development Commands

🔹 Start Development Server:

npm run dev

🔹 Build for Production:

npm run build

🔑 Admin Credentials

  • Username: istiak12@gmail.com
  • Password: 123Qw!

⚠️ For security reasons, avoid sharing sensitive credentials in public repositories.

About

BloodBanker is an online platform designed to connect blood donors and recipients, enabling seamless and efficient blood donation management. It allows users to register as donors, browse available donation campaigns, and get in touch with nearby blood banks or individuals in need.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages