Disaster X (developed by Persistence-Pixels) is a high-fidelity disaster management and situational awareness platform designed to optimize emergency response during high-stakes crises. The system transitions beyond traditional reporting tools by providing a Tactical HUD (Heads-Up Display) environment that integrates real-time geospatial intelligence, AI-driven survival protocols, and a resilient SOS communication chain.
The platform leverages React 18 for a high-performance frontend, Firebase Firestore for sub-second data synchronization, and the Google Gemini AI engine for generating localized, bulleted rescue intelligence. By centralizing fragmented data into a unified "Strategic Mission Control," Disaster X addresses the critical latency between disaster onset and life-saving intervention, aiming for a zero-casualty response model.
- Introduction
- System Architecture
- Module I — Tactical Command HUD
- Module II — KAVACH AI Sentinel
- Module III — Secure SOS & Beacon System
- Module IV — Survival Academy
- Technology Stack
- Installation & Setup
- Operational Ethos
- Authors & Team
Natural disasters displaced over 30 million people globally in 2023. The primary bottleneck in response is not a lack of resources, but information fragmentation. Responders often work with stale data, while survivors struggle to find actionable advice amidst the chaos.
Disaster X was engineered to eliminate this fog of war through three core pillars:
- Visual Intelligence: Converting raw coordinates into tactical heatmaps.
- Instant AI Guidance: Providing immediate, non-paragraphic rescue steps via KAVACH AI.
- Resilient Coordination: A centralized dashboard that synchronizes victims, responders, and relief assets in real-time.
Disaster X follows a Serverless Real-time Architecture, ensuring maximum uptime and horizontal scalability during peak disaster events.
- Frontend: Single Page Application (SPA) built with React/Vite, optimized for low-latency rendering.
- Data Bus: Firebase Firestore acts as the central reactive hub, pushing updates to all connected clients in <200ms.
- AI Layer: Edge-integrated Gemini API for localized crisis reasoning.
- Geospatial Layer: Mapbox/Google Maps API for tactical risk matrix visualization.
The HUD is the operational nerve center of Disaster X. It provides a high-contrast, "Dark Mode" interface designed for high-stress environments, reducing eye strain and highlighting critical data.
- Tactical Overlays: Visualizes active threats (Wildfires, Floods, Seismic activity) using dynamic SVG layers.
- Mission Dashboard: Displays live victim statistics, responder locations, and extraction point availability.
- Live Sync: Every marker on the map is a reactive component that updates instantly as field data arrives in Firebase.
KAVACH (meaning "Armor") is an integrated AI assistant powered by Google Gemini. Unlike generic chatbots, KAVACH is fine-tuned for "Tactical Brevity."
- Rescue Assistant: Processes natural language queries to provide immediate first-aid and evacuation steps.
- Bulleted Intel: Automatically formats complex disaster manuals into 3-5 high-priority action items.
- Multilingual Crisis Support: Communicates in regional dialects to ensure accessibility in diverse disaster zones.
The SOS module provides a one-click distress mechanism that bypasses complex navigation during emergencies.
- Emergency Beacon: Captures live GPS, device health, and timestamp data.
- Triage Priority: Algorithms rank incoming SOS signals based on proximity to high-risk zones and reported severity.
- Interactive Check-Ins: Sends automated "Safety Pings" to users in affected areas to track population health status.
Knowledge is the first line of defense. The Survival Academy gamifies disaster preparedness to ensure users are "Mission Ready" before a crisis hits.
- Strategic Manuals: High-fidelity, illustrated guides for various disaster scenarios.
- Interactive Drills: Scenario-based decision testing that rewards correct survival choices.
- Offline Cache: Essential survival documents are cached locally using Service Workers for zero-connectivity access.
| Technology | Purpose |
|---|---|
| React 18 | Core Application Framework |
| Vite | Next-gen Build Tooling |
| Tailwind CSS | Tactical Utility-First Styling |
| Framer Motion | Immersive Animations & Transitions |
| Technology | Purpose |
|---|---|
| Firebase Auth | Secure Identity Management |
| Firestore | Real-time NoSQL Data Bus |
| Gemini AI | Strategic Crisis Reasoning |
| Technology | Purpose |
|---|---|
| Mapbox/Google Maps | Tactical Mapping & Geo-visualization |
| OpenStreetMap | Reverse Geocoding Services |
- Node.js 18+
- Firebase Project
- Google AI (Gemini) API Key
-
Clone the Command
git clone https://github.com/ppranaypatil14-ops/Persistence-Pixels cd Persistence-Pixels -
Equip Dependencies
npm install
-
Configure Tactical Link (.env)
VITE_FIREBASE_API_KEY=your_key VITE_FIREBASE_AUTH_DOMAIN=your_domain VITE_FIREBASE_PROJECT_ID=your_id VITE_FIREBASE_STORAGE_BUCKET=your_bucket VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id VITE_FIREBASE_APP_ID=your_app_id VITE_FIREBASE_MEASUREMENT_ID=your_id VITE_GEMINI_API_KEY=your_gemini_key
-
Initialize Uplink
npm run dev
Disaster X is built on the foundation of resilience, transparency, and the pursuit of zero-casualty disaster response.
🤝 Contributing We welcome contributions from the open-source community. To contribute:
- Fork the repository
- Create a feature branch (
git checkout -b feature/your-feature-name) - Commit your changes with descriptive messages (
git commit -m 'Add feature: description') - Push to your branch (
git push origin feature/your-feature-name) - Open a Pull Request with a detailed description of your changes
Please ensure your code follows the existing project conventions and includes relevant documentation.
- Official partnerships with government disaster management agencies (NDMA, NDRF, State SDMAs).
- Legal compliance with data protection regulations (IT Act 2000, DPDP Act 2023).
- Verified integration with official emergency communication infrastructure.
- Security audits and penetration testing for all public-facing modules.
Anuja Pawar
GitHub: Anuja-3248
Pranay Patil
GitHub: ppranaypatil14-ops
Bhavika Patil
GitHub: Bhavika-0308
Harshita Jadhav
GitHub: harshita10
Email: anujap2222@gmail.com
Project Repository: https://github.com/ppranaypatil14-ops/Persistence-Pixels
❤️🔥 Made with dedication and Collaboration for Google Solution Challenge 2026 :)