Skip to content

Repository files navigation

🌍 GeoSentinel — Orbital Wildfire & Planetary Hazard Engine

Live Website API Status License: MIT

GeoSentinel is an enterprise-grade, full-stack geospatial intelligence platform. It aggregates live orbital telemetry from NASA satellites (MODIS & VIIRS), real-time atmospheric weather metrics, color-coded precipitation disaster warnings, and localized regional news to provide instant planetary hazard analysis—all rendered on a hardware-accelerated 60 FPS interactive map.

Screenshot 1 Screenshot 2 Screenshot 3


✨ Key Features

  • 🛰️ Live NASA Satellite Telemetry: Parses public 24-hour global CSV feeds from NASA FIRMS (MODIS 1km and VIIRS Suomi-NPP 375m thermal anomaly detectors).
  • 🌍 Hardware-Accelerated 60 FPS Canvas Map: Built on Leaflet GIS with HTML5 Canvas vector rendering to smoothly display thousands of global wildfire markers simultaneously.
  • 🌧️ IMD/WMO Color-Coded Rain & Storm Alert Engine: Automatically calculates 24-hour precipitation accumulation (mm) and rain probability (%) to issue RED, ORANGE, YELLOW, or GREEN severe weather advisories.
  • 📰 Regional & National News Radar: Reverse-geocodes clicked coordinates down to the state/country level, delivering live categorized dispatches across 6 sectors (Weather, Political, Business, Sports, Entertainment, Tech, and Science).
  • 🧠 Predictive AI Spread & Plume Vectors: Uses atmospheric wind vectors and relative humidity to project downwind smoke hazard cones and 6-hour cellular automata fire-spread fronts.
  • 🛡️ Safe Evacuation Route Engine: Dynamically calculates the center-of-mass of surrounding wildfires to plot an optimal escape vector pointing to the safest waypoint.
  • 🎨 Apple visionOS Liquid Glass UI: Translucent frosted glassmorphism, responsive spatial drawers, touch-friendly pill switches, and 10 customizable spatial themes with interactive hover-glowing icons.
  • MAP Google Maps Style Picker: Real-time tile layer toggling between Standard Streets, High-Res Satellite Imagery, Topographic Terrain, and CartoDB Dark Matter.
  • 🚨 Automated Discord Webhook Alerts: Direct emergency broadcast trigger for dispatching real-time JSON alert payloads to external webhooks.

🛠️ Tech Stack & Architecture

Frontend

  • Framework: React 18 + Vite
  • Mapping GIS: React-Leaflet, Leaflet (HTML5 Canvas vector rendering)
  • Icons: Lucide-React
  • Styling: Glassmorphism & visionOS Design Tokens

Backend

  • Runtime: Node.js + Express.js
  • Data Sources:
    • NASA FIRMS (Global MODIS C6.1 & VIIRS C2 active fire feeds)
    • Open-Meteo (Real-time temperature, humidity, wind vectors, precipitation)
    • Open-Meteo Air Quality API (US AQI & PM2.5 readings)
    • Nominatim OpenStreetMap (Reverse geocoding)
    • Google News RSS (Categorized regional and national news feeds)
  • HTTP Client: Axios

🚀 Getting Started Locally

Prerequisites

Make sure you have Node.js (v18 or higher) and npm installed.

1. Clone the Repository

bash git clone https://github.com cd GeoSentinel

2. Setup & Start Frontend

bash cd frontend npm install npm start

The frontend application will run on http://localhost:3000

3. Setup & Start Frontend

Open a second terminal window:

Bash cd frontend npm install npm run dev Open your browser and navigate to http://localhost:5173.

📖 API Endpoints Reference

Method Endpoint Query Parameters Description
GET /api/risk-assessment lat, lon, radius, source Returns weather, AQI, 24h rain alerts, evacuation vectors, and nearby NASA thermal anomalies.
GET /api/country-news lat, lon, scope, category Reverse-geocodes coordinates and returns live categorized regional/national news headlines.
POST /api/trigger-alert Body: { score, level, location, firesCount } Dispatches emergency warnings to a Discord webhook URL.

📜 License

Distributed under the MIT License. See LICENSE for more information.

👨‍💻 Author

Built with ❤️ by Krishna Gudavalli

Releases

Packages

Contributors

Languages