🌍 EarthSphere

Real-time NASA Earth & Space Event Intelligence Engine — powered by 13 NASA Open APIs across 15+ Interactive Dashboards.

🌐 Live Demo • 🏗️ Architecture • ✨ Features • 📡 NASA APIs • 🚀 Quick Start • 📈 Performance • 🐛 Report Bug

🌌 Overview

EarthSphere is an executive-grade, full-spectrum NASA Earth & Deep Space Intelligence Platform. It ingests telemetry from 13 official NASA Open APIs, delivering real-time monitoring across 15+ interactive pages — from natural events (wildfires, earthquakes, severe storms) to solar space weather, near-Earth asteroids, exoplanet discoveries, and Mars rover camera streams.

Designed with a cyber-glass sci-fi aesthetic, EarthSphere features a floating mega-menu navbar pill dock, cinematic WebGL 3D globe rendering, MapLibre GL 2D tactical vector mapping, and an accent theme customizer engine.

✨ Features

🌍 Interactive 3D WebGL Globe Scroll-reactive 3D Earth rendering built with Three.js. Features custom atmospheric glow shaders, particle rings, orbital event targeting, and cinematic camera transitions.	🗺️ 2D Tactical Map Engine Hardware-accelerated vector mapping powered by MapLibre GL JS. Features spatial marker clustering, category filtering, fly-to animations, and interactive event popups.
☄️ Asteroids & Fireballs Telemetry Real-time NASA NeoWs asteroid tracking with orbital velocity vectors, hazard ratings, and CNEOS atmospheric fireball impact telemetry analytics.	☀️ Space Weather (DONKI) Live solar activity monitoring from NASA DONKI: Coronal Mass Ejections (CMEs), X-class solar flares, and geomagnetic storm disturbance alerts.
🔴 Mars Rover Exploration Multi-rover raw photographic feeds from Perseverance, Curiosity, and Opportunity, filtered by Sol, Earth date, and camera sensors.	🛰️ Satellite Orbit Tracker Live 3D satellite tracking engine powered by TLE orbital elements, tracking the International Space Station (ISS) and Earth observation satellites.
📸 APOD & EPIC Earth Imagery Daily high-resolution Astronomy Picture of the Day and DSCOVR satellite EPIC full-disk Earth imagery with interactive date pickers.	💎 Sci-Fi Floating Pill Dock & Themes Frosted glassmorphism mega-menu navigation dock, custom accent theme switching (Cyan, Orange, Emerald, Purple), and zero-FOUC state persistence.

🌐 Live Modules & Route Directory

Click any module below to explore the live interactive dashboard on earthsphere.in:

Module	Route Path	Live URL	Features & Telemetry
🌍 3D WebGL Globe	`/`	earthsphere.in/	Real-time Earth EONET event globe with Three.js shaders
🗺️ 2D Tactical Map	`/map`	earthsphere.in/map	Vector tiles, marker clustering, MapLibre GL JS
📊 Telemetry Analytics	`/analytics`	earthsphere.in/analytics	Historical disaster trends & category breakdown
⚡ NASA Command Center	`/dashboard`	earthsphere.in/dashboard	Unified multi-API telemetry command dashboard
☄️ Asteroid Radar	`/asteroids`	earthsphere.in/asteroids	NASA NeoWs orbital velocity & threat rating
☀️ Space Weather	`/space-weather`	earthsphere.in/space-weather	DONKI Solar Flares, CMEs & Geomagnetic Storms
🔴 Mars Rover Explorer	`/mars`	earthsphere.in/mars	Perseverance, Curiosity & Opportunity Sol camera feeds
🌎 EPIC Earth Camera	`/epic`	earthsphere.in/epic	DSCOVR satellite full-disk polychromatic Earth views
📸 APOD Archive	`/apod`	earthsphere.in/apod	Astronomy Picture of the Day HD image viewer
🛰️ Satellite Tracker	`/satellites`	earthsphere.in/satellites	TLE orbital element telemetry & ISS 3D orbit
🔍 NASA Media Search	`/media`	earthsphere.in/media	Official NASA image & video library search engine
🛰️ Landsat Surface View	`/earth-imagery`	earthsphere.in/earth-imagery	Spectral satellite imagery & land surface tiles
🪐 Exoplanet Explorer	`/exoplanets`	earthsphere.in/exoplanets	Confirmed exoplanets discovery archive
💥 Fireballs Telemetry	`/fireballs`	earthsphere.in/fireballs	CNEOS atmospheric bolide energy impact data
🔬 TechPort Patents	`/techport`	earthsphere.in/techport	NASA space tech innovation & patent portfolio

📡 Integrated NASA Open APIs (13)

API Service	NASA API Endpoint	Key Features & Route
🌍 EONET v3	`eonet.gsfc.nasa.gov/api/v3/events`	Natural Disasters (Wildfires, Volcanoes, Storms) → `/events`, `/map`
📸 APOD	`api.nasa.gov/planetary/apod`	Astronomy Picture of the Day & Image Archive → `/apod`
☀️ DONKI	`api.nasa.gov/DONKI/`	Space Weather (CMEs, Solar Flares, Storms) → `/space-weather`
☄️ NeoWs	`api.nasa.gov/neo/rest/v1/feed`	Near-Earth Object orbits, hazard ratings → `/asteroids`
🌎 EPIC	`api.nasa.gov/EPIC/api/natural`	DSCOVR Full-Disk Earth Satellite Camera → `/epic`
🔴 Mars Rovers	`api.nasa.gov/mars-photos/api/v1/`	Perseverance, Curiosity, Opportunity Feeds → `/mars`
🔍 NASA Media	`images-api.nasa.gov/search`	NASA Official Image & Video Asset Search → `/media`
📡 Landsat / Earth	`api.nasa.gov/planetary/earth/`	Satellite Surface Spectral Imagery → `/earth-imagery`
🛰️ Satellite TLE	`celestrak.org` / TLE Feeds	Live ISS & Satellite Orbital Telemetry → `/satellites`
🪐 Exoplanets	NASA Exoplanet Archive	Confirmed Exoplanet Discoveries & Stars → `/exoplanets`
💥 Fireballs	`ssd-api.jpl.nasa.gov/fireball.api`	CNEOS Atmospheric Bolide Energy Data → `/fireballs`
🔬 TechPort	`api.nasa.gov/techport/api/`	NASA Space Tech Patents & Innovation → `/techport`
📊 NASA Command	Multi-endpoint Aggregator	Centralized System Telemetry Dashboard → `/dashboard`

🏗️ System Architecture

graph TD
    subgraph Client ["Client Layer (Next.js 15 App Router - 15+ Pages)"]
        UI[React 19 Server/Client Components]
        Navbar[Sci-Fi Floating Pill Dock / Mega-Menu]
        Globe[Three.js 3D WebGL Engine]
        Map[MapLibre GL Vector Engine]
        Store[Zustand Global State + Accent Themes]
    end

    subgraph DataLayer ["Data & Hook Architecture"]
        Hooks[useNasaApi Hook & TanStack Query SWR]
        Proxy[Next.js Edge API Proxy /api/events]
        Cache[(In-Memory Edge Cache)]
    end

    subgraph NASAEndpoints ["13 NASA Open API Endpoints"]
        EONET{EONET v3}
        DONKI{DONKI Space Weather}
        NeoWs{NeoWs Asteroids}
        MARS{Mars Rovers}
        EPIC{DSCOVR EPIC}
        APOD{APOD Archive}
        Media{NASA Media API}
    end

    UI -->|Navigates| Navbar
    UI -->|Requests Telemetry| Hooks
    Hooks -->|Cache Hit| Store
    Hooks -->|Fetch| Proxy
    Proxy -.->|Cache Miss| EONET
    Proxy -.->|Fetch| DONKI
    Proxy -.->|Fetch| NeoWs
    Proxy -.->|Fetch| MARS
    Proxy -.->|Fetch| EPIC
    Proxy -.->|Fetch| APOD
    Proxy -.->|Fetch| Media
    
    Proxy -->|Normalized Data| Hooks
    Hooks -->|Reactive Signals| Globe
    Hooks -->|Spatial Markers| Map
    
    style UI fill:#0f172a,stroke:#00d4aa,stroke-width:2px,color:#fff
    style Navbar fill:#1e293b,stroke:#00d4aa,stroke-width:2px,color:#fff
    style Globe fill:#0284c7,stroke:#00d4aa,stroke-width:2px,color:#fff
    style Map fill:#0d9488,stroke:#00d4aa,stroke-width:2px,color:#fff
    style Hooks fill:#1e293b,stroke:#38bdf8,stroke-width:2px,color:#fff
    style EONET fill:#1e1b4b,stroke:#818cf8,stroke-width:2px,color:#fff
    style DONKI fill:#312e81,stroke:#a855f7,stroke-width:2px,color:#fff
    style NeoWs fill:#431407,stroke:#f97316,stroke-width:2px,color:#fff

⚡ Tech Stack Matrix

Category	Technology	Usage Description
Framework	Next.js 15	App Router, Server Components, Edge Proxy API Routes
UI Library	React 19	Concurrent rendering, hooks, modular component trees
3D Graphics	Three.js	Custom WebGL Earth globe, orbital paths, shaders
2D Mapping	MapLibre GL JS	Vector tile mapping, clustering, custom markers
Styling	Tailwind CSS	Custom design tokens, glassmorphism, accent themes
Animation	Framer Motion	Page transitions, floating pill dock, scroll reveals
State & Query	Zustand + TanStack Query	Client state, SWR caching, retry logic
Charts	Recharts	Interactive telemetry charts for space weather & asteroids
Icons	Lucide React	Accessible icon system across 15+ routes

📂 Project Directory Structure

EarthSphere/
├── .github/                  # CI/CD Workflows, Dependabot, Issue & PR Templates
├── docs/                     # Architecture Specs, Design System, Changelog
├── public/                   # Static assets, OG images, favicons
├── src/
│   ├── app/                  # 15+ Next.js App Router Pages & API Routes
│   │   ├── analytics/        # EONET Historical telemetry dashboard
│   │   ├── apod/             # Astronomy Picture of the Day
│   │   ├── asteroids/        # NeoWs Near-Earth Asteroid tracking
│   │   ├── dashboard/        # NASA Command Center Telemetry
│   │   ├── earth-imagery/    # Landsat & MODIS satellite surface view
│   │   ├── epic/             # DSCOVR EPIC Earth polychromatic imagery
│   │   ├── events/           # Live EONET Natural Disaster list & detail
│   │   ├── exoplanets/       # Exoplanet Archive discovery explorer
│   │   ├── fireballs/        # CNEOS Fireball & Bolide energy impact data
│   │   ├── map/              # Fullscreen 2D/3D Tactical Vector Map
│   │   ├── mars/             # Perseverance, Curiosity & Opportunity rover feeds
│   │   ├── media/            # NASA Official Image & Video search library
│   │   ├── satellites/       # Live ISS & Satellite TLE orbit engine
│   │   ├── space-weather/    # DONKI Solar flares, CMEs & geomagnetic storms
│   │   └── techport/         # NASA Space Technology & Innovation portfolio
│   ├── components/           # Modular components (40+ components)
│   │   ├── 3d/               # WebGL Earth, ParticleField, Orbital Canvas
│   │   ├── features/         # ThemeCustomizer, SearchPalettes
│   │   ├── layout/           # Sci-Fi Floating Pill Dock Navbar, Footer
│   │   ├── map/              # EventMap, MapControls, Clustering
│   │   └── ui/               # GlassCard, StatusBadge, CustomCursor
│   ├── hooks/                # useNasaApi, useEvents, useTheme custom hooks
│   ├── lib/                  # nasa-api.ts client, design-tokens, store.ts
│   └── types/                # nasa.ts TypeScript interfaces for 13 APIs
├── CONTRIBUTING.md           # Developer guidelines & Conventional Commits rules
├── LICENSE                   # MIT Open Source License
└── SECURITY.md               # Enterprise vulnerability disclosure policy

📈 Performance Scorecard

🚀 Performance: 99 / 100 (Lighthouse Mobile & Desktop)
🎯 SEO: 100 / 100 (Fully SSR metadata & Open Graph schema across 15+ routes)
♿ Accessibility: 95 / 100 (WCAG AA compliant, reduced-motion fallback)
🔒 Best Practices: 100 / 100 (Strict CSP headers, sanitized map markers)
🔋 Power Efficiency: Auto-pauses WebGL rendering loops when browser tab is inactive.

🗺️ Product Roadmap

v1.0 Release — Next.js 15 Migration, Three.js 3D Globe, MapLibre GL Integration.
v1.2 Release — Cyber-Glass Design System overhaul, Edge API Proxy with caching.
v2.0 Release — 13 NASA Open APIs Integration, 11 New Interactive Pages, Floating Mega-Menu Pill Dock, Accent Theme Customizer.
v2.1 (Upcoming) — AI-powered Natural Disaster Impact & Solar Storm Forecasting.
v2.2 (Upcoming) — Custom Geofence Satellite Alerts & PWA Push Notifications.

⭐ Star History

🤝 Contributing & Community

Contributions are what make the open-source community an extraordinary place to learn, inspire, and create.

Please review our Contributing Guidelines before submitting pull requests.
Read our Code of Conduct to understand community standards.
Check out SECURITY.md for security reporting.

📜 License

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

Built with ❤️ by Abhilash & the EarthSphere Contributors.

Space & Earth Telemetry provided by NASA Open APIs.

Name		Name	Last commit message	Last commit date
.github		.github
docs		docs
public		public
src		src
.editorconfig		.editorconfig
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CITATIONS.cff		CITATIONS.cff
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
components.json		components.json
eslint.config.mjs		eslint.config.mjs
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

Navigation Menu

Repository files navigation

🌍 EarthSphere

🌌 Overview

✨ Features

🌍 Interactive 3D WebGL Globe

🗺️ 2D Tactical Map Engine

☄️ Asteroids & Fireballs Telemetry

☀️ Space Weather (DONKI)

🔴 Mars Rover Exploration

🛰️ Satellite Orbit Tracker

📸 APOD & EPIC Earth Imagery

💎 Sci-Fi Floating Pill Dock & Themes

🌐 Live Modules & Route Directory

📡 Integrated NASA Open APIs (13)

🏗️ System Architecture

⚡ Tech Stack Matrix

📂 Project Directory Structure

📈 Performance Scorecard

🗺️ Product Roadmap

⭐ Star History

🤝 Contributing & Community

📜 License

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

🌍 EarthSphere

🌌 Overview

✨ Features

🌍 Interactive 3D WebGL Globe

🗺️ 2D Tactical Map Engine

☄️ Asteroids & Fireballs Telemetry

☀️ Space Weather (DONKI)

🔴 Mars Rover Exploration

🛰️ Satellite Orbit Tracker

📸 APOD & EPIC Earth Imagery

💎 Sci-Fi Floating Pill Dock & Themes

🌐 Live Modules & Route Directory

📡 Integrated NASA Open APIs (13)

🏗️ System Architecture

⚡ Tech Stack Matrix

📂 Project Directory Structure

📈 Performance Scorecard

🗺️ Product Roadmap

⭐ Star History

🤝 Contributing & Community

📜 License

About

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages