FireSight

🔥 FireSight

Every spark in sight. 🛰️👁️

Early wildfire detection — worldwide, free, and often before the media.

🌍 Built for NextStep Hacks 2026 — theme: Earth Forward 🌱

Next.js React TypeScript Tailwind CSS MapLibre GL

Supabase NASA FIRMS NOAA GOES EUMETSAT MCP Server

CI License: CC BY 4.0 Languages PRs Welcome

🐤 The canary once sang in the coal mine. FireSight simply keeps its eyes on the fire — satellites, sensors and verified witnesses — so every ignition is seen the moment it starts.

⚠️ FireSight is an information service, not an official alert channel. In an emergency call 112 (Europe), 911 (North America), 193 (Brazil) or your local emergency number.

📑 Table of Contents

• 🌍 The Problem
• 💡 The Solution
• 📸 Demo
• ✨ Features
• 🏗️ Architecture
• 🧠 How It Works
• 🧰 Tech Stack
• 🔌 API, Open Data & MCP
• 🚀 Getting Started
• 📂 Project Structure
• 🏆 Why FireSight Wins (Judging Criteria)
• 🗺️ Roadmap
• 🤝 Contributing
• 📜 License & Citation

🌍 The Problem

Wildfires are getting bigger, faster and more frequent — and the first hours decide everything. Yet today:

The result: every wildfire season, communities are surprised by fires that satellites had already seen. 🔥

💡 The Solution

FireSight is a free, independent, near real-time world map of wildfire ignitions. It sees the spark the moment it starts — and tells everyone, in 4 languages, for free.

One goal: surface fire starts as early as possible — often before the media. ⏱️

📸 Demo

🌍 Live 3D globe — every active ignition on Earth, updated every few minutes. 15 firefighting aircraft airborne. 116 active fires in Russia right now.

🕐 24-hour window over the Americas — 254 active fires in Brazil, tracked in real time.

🔎 Zoom into South America — clustered fire events, per-country live counters, one-tap area alerts.

✨ Features

🏗️ Architecture

flowchart TB
    subgraph Space["🛰️ Eyes in the Sky"]
        FIRMS["🔥 NASA FIRMS<br/>VIIRS 375 m"]
        GOES["🌎 NOAA GOES"]
        MTG["🌍 EUMETSAT<br/>Meteosat MTG · 10 min"]
    end

    subgraph People["🗣️ Eyes on the Ground"]
        BSKY["🦋 Bluesky"]
        GDELT["📰 Press via GDELT"]
        TG["✈️ Telegram"]
        USERS["🆘 User reports<br/>+ photos"]
    end

    subgraph Sky["✈️ Firefighting Fleet"]
        ADSB["📡 ADS-B<br/>aircraft telemetry"]
    end

    subgraph Brain["🧠 FireSight Core — Next.js 16 App Router"]
        INGEST["📥 Ingestion<br/>firms · goesdirect · mtg"]
        CLUSTER["🧮 Event Clustering<br/>~4 km grid · 8-neighbour<br/>connected components"]
        GEO["🗺️ Geoparsing<br/>gazetteer"]
        TRIAGE["🤖 AI Triage ×2<br/>independent models<br/>budget-capped · cached 7 d"]
        CONF["🚦 Confidence Engine<br/>possible → probable → corroborated"]
        ARCHIVE["📖 Fire Archive<br/>permanent pages"]
        PRECO["⏱️ Precocity Meter<br/>our lead time vs press"]
    end

    subgraph Store["💾 Data Layer"]
        SUPA[("🐘 Supabase<br/>fire events · signals<br/>analytics · trends")]
        BLOB[("☁️ Vercel Blob<br/>caches · verdicts")]
    end

    subgraph Out["🚪 Output — free for everyone"]
        MAP["🗺️ Live Map<br/>FR · EN · ES · PT"]
        API["🔌 REST API<br/>JSON · CSV · RSS"]
        MCP["🤖 MCP Server<br/>Claude · ChatGPT · Cursor"]
        PUSH["🔔 Web-Push Alerts"]
        WIDGET["🧩 Embeddable Widget"]
        OPEN["📦 Open Data<br/>CC BY 4.0"]
    end

    CRON["⏰ GitHub Actions<br/>cron every 5 min"] --> Brain

    FIRMS & GOES & MTG --> INGEST
    BSKY & GDELT & TG --> GEO
    USERS --> TRIAGE
    ADSB --> MAP

    INGEST --> CLUSTER
    GEO --> TRIAGE
    TRIAGE --> CONF
    CLUSTER --> CONF
    CONF --> ARCHIVE
    ARCHIVE --> PRECO

    CLUSTER --> BLOB
    TRIAGE --> BLOB
    CONF --> SUPA
    ARCHIVE --> SUPA

    SUPA --> MAP & API & MCP & OPEN
    BLOB --> MAP
    CONF --> PUSH
    MAP --> WIDGET

stateDiagram-v2
    [*] --> possible: 🛰️ single satellite detection
    possible --> probable: 🛰️🛰️ multiple detections<br/>or high FRP confidence
    probable --> corrobore: 🗣️ AI-verified witnesses<br/>within range
    possible --> corrobore: 🗣️ strong corroborated signal
    corrobore --> archived: 📖 significant event →<br/>permanent page + API + open data
    probable --> archived: ⚡ above power thresholds
    archived --> [*]: feeds observatory,<br/>daily reports & stats

🧠 How It Works

1. 🛰️ Satellites spot the heat. Hotspots from NASA FIRMS, GOES and Meteosat MTG are clustered into fire events on a ~4 km grid (8-neighbour connected components). The first detection = proxy for ignition time.
2. 🗣️ Humans confirm it. Public witness reports (Bluesky, press via GDELT, Telegram) are geoparsed against a gazetteer, then judged twice by independent AI models — is this a fire happening right now, and where exactly? (Goodbye, "The Globe and Mail" → Globe, Arizona traps. 😉)
3. 🚦 Trust is earned. Events climb possible → probable → corroborated. Significant events get a permanent archive page; aggregates feed the observatory, daily reports and the API.
4. ✈️ Help is tracked. Firefighting aircraft are identified from ADS-B (registration, ICAO type) and shown live.
5. ⏱️ We measure ourselves. The precocity module compares our first detection against first press coverage — and publishes the lead time.

🧰 Tech Stack

📈 By the numbers

🔌 API, Open Data & MCP

Everything is free — no key, no account. Attribution required: "Source: FireSight" (CC BY 4.0).

🤖 MCP tools: active_fires · fire_archive_search · fire_details · wildfire_stats · firefighting_aircraft · earliness_cases — registry manifest in server.json.

🚀 Getting Started

# 1️⃣ Clone it
git clone https://github.com/theyapguard/FireSight.git
cd FireSight

# 2️⃣ One free key is enough for the live map
#    Get yours: https://firms.modaps.eosdis.nasa.gov/api/map_key/
echo "FIRMS_MAP_KEY=your_key" > .env.local

# 3️⃣ Run it
npm install
npm run dev

🎉 Open http://localhost:3000 — the map is live.

💡 Archive, witness signals and aircraft need Supabase + a few provider keys — but every page degrades gracefully without them. Our CI builds and runs the full SEO guard with zero secrets.

📂 Project Structure

FireSight/
├── 🛰️ src/lib/
│   ├── firms.ts · goesdirect.ts · mtg.ts   # satellite ingestion
│   ├── cluster.ts                          # ~4 km event clustering
│   ├── social.ts · triage.ts · press.ts    # witness reports + double AI verification
│   ├── firearchive.ts · observatory.ts     # fire memory + aggregates
│   ├── precocity.ts                        # measured earliness vs press
│   └── aircraft.ts · perimeters.ts · firerisk.ts
├── 🗺️ src/components/FireMap.tsx           # MapLibre GL live map
├── 🌐 src/app/[lang]/…                     # pages in FR · EN · ES · PT
├── 🔌 src/app/api/                         # events · signals · mcp · report · …
├── 📦 src/app/opendata/                    # open-data CSV
├── 🧰 packages/firesight-fires/            # dependency-free JS client
├── 🐘 supabase/                            # SQL schemas
├── ⏰ .github/workflows/                   # CI + cron ingestion
└── 🛡️ scripts/seo-guard.mjs                # structural SEO contracts in CI

🏆 Why FireSight Wins (Judging Criteria)

🗺️ Roadmap

• 🛰️ Multi-satellite live detection (FIRMS + GOES + MTG)
• 🤖 Double-AI witness verification
• ✈️ Live firefighting aircraft tracking
• 🔔 Free area alerts (web-push)
• 📖 Permanent fire archive + observatory
• 🤖 MCP server for AI agents
• 📱 Native mobile app (PWA first)
• 🌫️ Smoke-drift forecasting
• 🏘️ Community verification network with local organizations
• 📡 DOI for the open dataset

🤝 Contributing

Ideas, data sources, bug reports — all welcome! 🙌

1. 📥 Clone the repo: git clone https://github.com/theyapguard/FireSight.git
2. 🌿 Create a branch: git checkout -b feat/my-idea
3. 💾 Commit: git commit -m "feat: my idea"
4. 🚀 Open a PR — CI (types + build + SEO guard) must pass ✅

📜 License

MIT — free to use, learn from, and build on.