PulsePoint - Crisis Reporting & Visualization Platform

Project Description

PulsePoint is a real-time crisis reporting and visualization platform that empowers users to report emergencies such as fires, medical issues, accidents, and natural disasters.

Using a simple, clean interface, users can submit crisis reports by describing the situation, entering their location manually or using GPS auto-detection, and selecting urgency levels. Each report immediately generates a live, color-coded marker on an interactive map, helping communities and responders identify critical hotspots as they evolve.

PulsePoint bridges the gap between isolated incidents and immediate awareness — helping build faster, more resilient responses during critical moments.

🧩 ##Key Features 📍 Real-time Crisis Reporting: Users can instantly submit details of any crisis happening around them.

🌍 Interactive Map Visualization: All reports are visualized live on a map with urgency-based colored markers.

📡 Location Detection: Auto-detect user's current location or allow manual location entry.

🚨 Urgency Prioritization: Markers colored based on urgency level — Critical 🔴, High 🟠, Medium 🔵, Low 🟢.

📝 Detailed Report Popups: Clicking markers shows detailed info: Description, Location, Time, Status.

🔄 Instant Updates: Newly submitted reports immediately update the map without page reloads.

🎨 Smooth Animations: New markers bounce into the map for a professional, engaging experience.

📱 Responsive Design: Fully mobile-friendly with a clean UI for phones, tablets, and desktops.

🗂️ Sidebar List View: Browse all submitted reports in an easy-to-read sidebar format.

💬 How to Use / Demo Instructions Go to the homepage.

Click on the "+" floating action button to submit a new crisis report.

Fill out the description, select category, choose urgency, and detect or enter location.

Submit!

Watch a new marker instantly appear on the map.

Click any marker to view full crisis details.

👉 No login required. Simple, fast, and accessible to everyone.

⚡ ##Challenges We Faced Integrating dynamic real-time map updates with user submissions without refreshes.

Handling geolocation permissions cleanly when users deny GPS access.

Designing an interface that remains clean and readable even with many markers.

Managing backend validation to ensure safe, accurate data storage.

Balancing minimalism and feature richness in our UI under strict time limits.

🚀 ##What’s Next 🚑 Notification system: Alert nearby users based on new high-urgency reports.

🗺️ Routing Integration: Suggest safe routes around critical areas.

📱 Mobile App Version: Create a dedicated mobile application.

🧠 AI Summarization: Cluster multiple similar reports into summarized incidents.

🧩 Admin Panel: Verify, edit, and prioritize critical reports.

🛠️ ##Built With React.js (Frontend framework)

Vite.js (Build tool for faster frontend development)

TailwindCSS (Beautiful, responsive UI styling)

Framer Motion (Smooth animations and transitions)

Leaflet.js + React-Leaflet (Interactive maps)

MongoDB Atlas (Cloud database)

Express.js + Node.js (Backend server and API)

Mongoose (MongoDB ORM for easier database operations)

PostCSS (CSS processing)

Axios (Frontend-backend communication)

Vercel / Render (Optional - Hosting frontend and backend)