Skip to content

johnsmalls22-rgb/hormuz-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hormuz Tracker — Real-Time Strait of Hormuz Intelligence Dashboard

Live vessel tracking, oil price monitoring, dark ship detection, and naval force positions for the world's most critical maritime chokepoint.

Live Demo | Full Analysis on The Board

Hormuz Tracker Dashboard

What It Tracks

  • 88+ vessels in real-time via AIS (Automatic Identification System)
  • Dark ships — vessels with disabled transponders, estimated positions in the shipping lane
  • Oil prices — Brent & WTI with historical charts (EIA + FRED data)
  • Transit history — daily vessel counts through the strait (IMF PortWatch)
  • US Navy carrier positions — 10 carriers tracked via GDELT/USNI intelligence
  • 7-day maritime weather — wind warnings, gust forecasts (Open-Meteo)
  • Breaking news — Google News RSS for Hormuz-related headlines
  • Crisis analytics — economic impact estimates, bypass route capacity, escalation index

Why Hormuz Matters

21 million barrels of oil pass through the Strait of Hormuz daily — roughly 21% of global consumption. A blockade would trigger the largest energy crisis in history.

For in-depth geopolitical analysis: The Board — Geopolitical Intelligence

Tech Stack

  • Frontend: Next.js 16 + React 19 + Tailwind CSS 4
  • Map: Mapbox GL JS with custom GeoJSON layers
  • Charts: Recharts
  • Data Sources: AISStream, IMF PortWatch, EIA, FRED, Open-Meteo, GDELT, Google News RSS

Getting Started

git clone https://github.com/johnsmalls22-rgb/hormuz-tracker.git
cd hormuz-tracker
npm install
cp .env.example .env.local
# Add your API keys to .env.local
npm run dev

Open http://localhost:3000.

API Keys (all free)

Service Get Key What It Provides
Mapbox Free tier (50K loads/mo) Map rendering
EIA Free Oil spot prices
FRED Free Historical oil data

Weather, transit history, news, and carrier data require no API keys.

Data Sources & Attribution

Data Source Update Frequency
Vessel positions AISStream Real-time (5s)
Transit counts IMF PortWatch Daily
Oil prices EIA + FRED Daily
Carrier positions USNI News + GDELT Hourly
Weather Open-Meteo Hourly
News Google News RSS 5 minutes

Related

License

MIT

About

Real-time Strait of Hormuz vessel tracking, oil price monitoring, and naval intelligence dashboard. Live AIS data, dark ship detection, carrier positions, and crisis analytics.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages