Skip to content

YoussefElshafei/BridgeAid-Project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🌉 BridgeAid

A disaster‑response platform for the Hamilton & McMaster community — built to scale nationwide.


Connecting Communities in Times of Crisis

Status Built With Database Maps Security


🌍 Overview

As climate change accelerates, Canada is facing more frequent wildfires, floods, storms, and extreme weather events. During crises, information fragmentation and delayed coordination can cost lives.

BridgeAid is a unified, real‑time disaster response platform designed to:

  • 🧠 Educate communities on disaster preparedness
  • 🚨 Report verified local emergencies
  • Request essential aid quickly and clearly
  • 🤝 Mobilize volunteers
  • 📊 Track recovery progress

Built with security, scalability, and usability at its core, BridgeAid bridges citizens, volunteers, and responders when it matters most.


🚀 Core Features

🛡 Prepare

An educational hub focused on readiness and prevention:

  • Disaster‑specific safety guides
  • Downloadable emergency checklists
  • Curated informational videos
  • 🧪 Test Your Knowledge interactive quiz

🚨 Report Incidents

Reliable, misinformation‑resistant incident reporting:

  • Logged‑in users submit verified reports
  • 🤖 AI‑assisted cross‑checking with other reports & official datasets
  • Only verified incidents appear on the live map
  • Designed to reduce false or panic‑driven reporting

❤ Request Aid

Fast, structured aid requests during emergencies:

Users can request:

  • 🍞 Food
  • 🏠 Shelter
  • 🩺 Medical attention
  • 📦 Emergency supplies

Each request includes:

  • 📍 Location
  • ⏱ Urgency level
  • 👨‍👩‍👧 Household size
  • 🧾 Type of aid required

🔮 Coming soon: aid‑center mapping, request tracking, and in‑app messaging.


🤝 Volunteer

Empowering community‑driven response:

  • Quick volunteer onboarding
  • Category selection (Food Bank, Shelter, Disaster Relief, etc.)
  • 👥 Live volunteer list with active / standby status
  • Register as an active responder during emergencies

📊 Recovery Dashboard

High‑level insight into crisis impact and recovery:

  • 📈 Incident count & people affected
  • 🌎 Toggle between local and global data
  • Simulated recovery progress visualization
  • Clear post‑crisis overview for communities

🗺️ Interactive Live Map

Real‑time spatial awareness powered by Leaflet:

  • 🧭 Dynamic, zoomable map
  • Displays verified active incidents only
  • Updates in real time as new reports are confirmed

🛠 Tech Stack

🎨 Frontend

  • ⚛️ React
  • 🧱 HTML
  • 🎨 TailwindCSS
  • 🗺️ Leaflet (live mapping)
  • Vite
  • 📜 JavaScript

🧠 Backend

  • 🐍 Python
  • 🌐 Flask
  • 🔌 RESTful API architecture

🗄️ Database

  • 🐘 PostgreSQL

🔐 Security

  • 🔑 JWT Authentication (JSON Web Tokens)
  • ✅ Robust input validation
  • 🚦 API request throttling
  • 🧯 Server‑side error handling

🧠 Why This Project Matters (For Recruiters)

BridgeAid demonstrates real-world engineering skills applied to a high-impact problem:

  • 🌍 Social impact: disaster response, climate resilience, community safety
  • 🏗️ System design: full-stack architecture with clear separation of concerns
  • 🗺️ Geospatial data: live mapping, spatial reasoning, real-time updates
  • 🤖 AI-assisted logic: misinformation reduction via report cross-checking
  • 🔐 Security-first mindset: JWT auth, validation, throttling

This project reflects how production systems are designed — not just how demos are built.


🧩 System Architecture

Frontend (React + Tailwind)
        ↓ REST API
Backend (Flask + Python)
        ↓
PostgreSQL Database
        ↓
External Data Sources (future)
  • Modular frontend components
  • Stateless RESTful backend
  • Scalable database design
  • Easily extendable for national deployment

⚙️ Getting Started

# Clone the repository
git clone https://github.com/your-username/bridgeaid.git
cd bridgeaid

# Frontend
cd frontend
npm install
npm run dev

# Backend
cd backend
pip install -r requirements.txt
python app.py

Requires Node.js, Python 3.10+, and PostgreSQL


📸 Screenshots & Demo

Screenshots and a short demo video will be added soon.

Planned visuals:

  • 🗺️ Live incident map
  • 🚨 Incident reporting flow
  • ❤ Aid request form
  • 🤝 Volunteer dashboard

🚧 Roadmap

  • 🧭 Aid center discovery & routing
  • 💬 In-app messaging between volunteers and requesters
  • 📱 Mobile-responsive PWA
  • 🛰️ Integration with official emergency datasets
  • 🧠 Improved AI verification logic

🌱 Vision

BridgeAid is designed to scale beyond Hamilton — enabling a unified disaster-response infrastructure across Canada.

When systems fail, communities shouldn’t. BridgeAid exists to keep people connected, informed, and supported — when it matters most.


💼 Built to impress recruiters. Designed to help communities.

About

As climate change accelerates, Canada is facing more frequent wildfires, floods, storms, and extreme weather events. During crises, information fragmentation and delayed coordination can cost lives. BridgeAid is a unified, real‑time disaster response platform designed to address these issues.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors