ResQ — Disaster Management System

A modern, premium frontend disaster-management platform built with HTML, Tailwind CSS, and vanilla JavaScript. It helps communities report incidents, raise SOS alerts, coordinate volunteers, track weather, and stay prepared — with a polished glassmorphism UI, dark mode, and smooth animations.

Final-year / hackathon-ready single-page application. Works fully in the browser with localStorage for demo data and Firebase for authentication.

---

✨ Highlights

• 🎨 Premium UI — Tailwind CSS, glassmorphism cards, gradients, micro-animations
• 🌙 Dark mode — system-aware, persisted across sessions
• 📱 Mobile-first — responsive navbar with hamburger menu
• 🔐 Auth + Guest mode — Firebase email/password, plus Continue as Guest
• 📊 Live dashboard — animated counters, Chart.js charts, recent-incidents table, Leaflet map
• 🚨 Emergency SOS — confirmation popup, geolocation, contacts & nearby hospitals
• 📝 Report incident — validation, image preview, GPS, localStorage persistence
• 👥 Community — posts, likes, comments
• 📚 Resources — searchable, filterable guides + downloadable checklist
• 🌦 Weather — OpenWeather integration with graceful demo fallback
• 🙋 Volunteers — registration, skills, availability, leaderboard
• 💬 AI assistant — floating rule-based chatbot

🧭 Guest Mode

Guests can browse the dashboard, resources, weather and community feed. Actions that change data (report incident, post, comment, volunteer) prompt a friendly sign-in gate.

📂 Project Structure

.
├── index.html              # Entry router → home (signed-in/guest) or login
├── pages/
│   ├── home.html           # Main single-page app (all sections)
│   ├── login.html          # Sign in + Continue as Guest
│   └── signup.html         # Create account
├── css/
│   └── style.css           # Design tokens, glassmorphism, animations
├── js/
│   ├── config.js           # API keys & settings
│   ├── auth.js             # Firebase auth + guest session (ES module)
│   ├── app.js              # SPA core: routing, theme, guest gating, counters, sections
│   ├── incident.js         # Report form + recent incidents
│   ├── sos.js              # Emergency SOS
│   ├── community.js        # Posts / likes / comments
│   ├── resources.js        # Guides search & filter
│   ├── weather.js          # OpenWeather + demo fallback
│   ├── volunteer.js        # Registration + leaderboard
│   ├── charts.js           # Chart.js dashboards & analytics
│   ├── map.js              # Leaflet incident map
│   └── chatbot.js          # Floating AI assistant
└── Emergency-Preparedness-Checklist.pdf

🚀 Run Locally

No build step required — it's a static site.

# from the project root
python -m http.server 8000
# then open http://localhost:8000

Or open index.html with any static server / Live Server extension.

🔧 Configuration

• Firebase auth config lives in js/auth.js.
• OpenWeather key lives in js/config.js (apiKeys.openWeatherMap). Without a valid key, the Weather section automatically shows realistic demo data.

🛠 Tech Stack

Tailwind CSS (Play CDN) · Vanilla JS (ES modules) · Chart.js · Leaflet · Font Awesome · Firebase Auth · OpenWeather API

📄 License

MIT