Skip to content

jdbostonbu-ops/ReliefMesh

Repository files navigation

πŸ†˜ ReliefMesh: Peer-to-Peer Disaster Response

A real-time, "Last-Mile" resource exchange for local communities during crises.

πŸ‘€ Author

Jacqueline
Check out my GitHub Profile

πŸš€ Visit ReliefMesh

🌐 Browser & Device Compatibility

Browser / Device Status Performance Notes
Google Chrome βœ… Compatible Full support for Chrome and Chromium-based rendering. Optimized for Firebase sync.
Microsoft Edge βœ… Compatible Full support for Edge (Chromium) rendering. Optimized for Mapbox GL performance.
Safari βœ… Compatible Full support for Safari and WebKit rendering. Optimized for SVG marker pulsing.
Firefox βœ… Supported Full support. Verified for interactive post cards and coordinate mapping.
iPad & Tablets βœ… Supported Full support. Verified for interactive post cards and coordinate mapping.
iPhone (iOS) ⚠️ Limited Landscape Orientation only. Must be viewed at 50% zoom-out for UI scaling.

πŸ“± Special Instructions for iPhone specific Mobile Devices

ReliefMesh is currently optimized for desktop-first interactions. For the best experience on iPhone:

  1. Rotate your device to Landscape Mode.
  2. Set your browser zoom to 50% (via the AA menu in Safari or Browser Settings in Chrome).

🌍 The Problem

During disasters, official dashboards focus on infrastructure (power grids, roads). Individual human needsβ€”"I need insulin," "I have a generator to share"β€”are often lost in the noise.

πŸš€ The Solution

A "Tinder-style" matching system for crisis relief. Users can swipe through nearby resource offers or requests within a 5-mile radius, even when traditional networks are strained.

πŸ›  Tech Stack

  • Frontend: Vite + Vanilla JS (or React)
  • Maps: Mapbox GL JS (3D Terrain & Heatmaps)
  • Database: Firebase Realtime Database (Instant Sync)
  • Auth: Firebase Auth (Secure User Profiles)
  • Styling: Tailwind CSS (Mobile-First Design)

⚑ Key Features

  • Live SOS Map: Pulse markers for urgent medical, food needs, utility and shelter.
  • Resource Cards: "Claim" or "Offer" to help a neighbor.
  • Geocoding (turning an address into a pin)
  • Spatial Mapping (showing icons based on coordinates).
  • Offline-First: Basic UI caching for low-connectivity environments.

Why my version of ReliefMesh is actually "Competitive":

  • Peer-to-Peer (P2P): FEMA is "Top-Down" (Government to Citizen). My app is "Side-to-Side" (Neighbor to Neighbor). In a real disaster, neighbors usually help each other hours or days before a FEMA truck arrives.
  • The "Mother Earth" Visual: By using the 3D Globe, I make it easy for a global org like Johns Hopkins to see "Hotspots" of needs across an entire continent at a glance.
  • Speed (Firebase): My app updates in milliseconds. Most government tools are slow, require logins, and have massive forms to fill out. How they would use it:
  • FEMA: They could use your data to see where the "pockets of need" are to decide where to send their supply trucks.
  • Johns Hopkins: They could use the Medical (Red) markers to track the spread of a health crisis or where oxygen/insulin is running low in real-time.

About

πŸ›°οΈ Interactive 3D mesh visualization & P2P crisis relief platform. Built with Mapbox GL JS and Firebase for high-speed, neighbor-to-neighbor resource sharing. πŸ› οΈπŸ”₯

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages