Real-time satellite monitoring platform for the African continent. Combines NASA GIBS imagery, live fire hotspots, lightning strikes, earthquakes, cyclones, and precipitation into a single dark-themed command-centre interface.
# Africa Live Eye
Real-time satellite monitoring platform for the African continent. Combines NASA GIBS imagery, live fire hotspots, lightning strikes, earthquakes, cyclones, and precipitation into a single dark-themed command-centre interface.
---
## Feature Overview
| Category | Feature | Data Source |
|---|---|---|
| **Imagery** | VIIRS 375m, MODIS Terra/Aqua 250m, Esri sub-meter | NASA GIBS |
| **Fire hotspots** | Live VIIRS active fire detections, refreshed every 3h | NASA FIRMS |
| **Lightning** | Real-time strikes (Blitzortung) or synthetic fallback | Blitzortung WS |
| **Earthquakes** | M2.5+ events, depth-coded colour rings | USGS GeoJSON |
| **Cyclones** | Active tropical storms with track lines | GDACS API |
| **Precipitation** | GPM IMERG 2 km rain-rate overlay | NASA GIBS |
| **Time animation** | Play through up to 30 days of imagery automatically | — |
| **Split-screen** | Compare two dates side-by-side with a draggable divider | — |
| **Analytics** | 7-day fire trend bar chart + earthquake magnitude doughnut | Chart.js |
| **Alert zones** | Draw a polygon, get browser notifications when events enter | Browser API |
| **PDF report** | Export map screenshot + data tables as landscape A4 PDF | jsPDF |
| **Live aircraft** | OpenSky Network transponder positions | OpenSky REST |
| **Locate Me** | Show your current GPS position on the map with a pulsing marker | Browser Geolocation API |
---
## Quick Start
```bash
# 1. Clone the repository
git clone
github.com
cd Africa-Live-Eye
# 2. Install dependencies
npm install
# 3. Configure secrets
cp .env.example .env
# edit .env — add your FIRMS_API_KEY (and optionally MAPBOX_TOKEN)
# 4. Start the server
npm start
# Open
localhost
```
The app runs in **demo mode** without API keys — fire hotspots and lightning are synthesised from realistic Africa distributions so every feature works out of the box.
---
## Environment Variables
Copy `.env.example` t …