Skip to main content

Roadmap

What We're Building

From Philippine fuel intelligence to a global energy disruption map. This is our phased plan to build the pandemic-tracker equivalent for energy markets.

7 Shipped
0 In Progress
14 Planned
Phase 1

Philippines Foundation

Core infrastructure for PH fuel market intelligence

WebGL map with 10,469 gas stations

Shipped

Interactive WebGL-powered map rendering all known gas stations across the Philippines sourced from OpenStreetMap. Enables spatial analysis of fuel access, coverage gaps, and brand concentration at a national scale.

mappingdata

Live Brent crude and PHP/USD forex feeds

Shipped

Real-time integration of Brent crude oil prices and PHP/USD exchange rates to compute import parity pricing. Gives users an instant read on whether local pump prices reflect current global market conditions.

pricesapi

RSS news aggregation with NLP sentiment

Shipped

Automated aggregation of energy news from DOE, major publications, and wire services, scored for sentiment using NLP. Surfaces bullish or bearish signals around fuel prices before they hit the pump.

newsai

Scenario planner and Monte Carlo stress testing

Shipped

Interactive simulator letting users model the pump-price impact of crude oil shocks, peso depreciation, and excise tax changes. Monte Carlo engine generates probability distributions so policymakers and consumers can plan for tail risks.

analysissimulation

AI agent discoverability — llms.txt, ai-manifest.json

Shipped

Published llms.txt and ai-manifest.json metadata so AI assistants and autonomous agents can discover, understand, and integrate with this dashboard programmatically. Positions the project as a machine-readable energy data endpoint.

aideveloper
Phase 2

Philippine Data Enrichment

Richer, more granular PH-specific data feeds

DOE actual pump price feeds

Shipped

Pump prices now sourced from DOE Oil Monitor weekly SRP instead of derived import-parity estimates. Reflects actual Metro Manila prices including disruption premiums not captured by the Brent + forex model.

pricesgovernment

Second-order cascade effects tracker

Shipped

Visual cascade map showing how oil price shocks ripple through the Philippine economy — from crude oil to diesel, agriculture, transport, and household budgets. Tracks 11 nodes across 5 categories with 16 causal links.

analysisvisualization

Google Places station enrichment

Planned

Augment OSM station data with Google Places attributes including operating hours, user ratings, photos, and amenities. Transforms raw coordinate data into actionable consumer information.

mappingenrichment

Historical price charts

Planned

Time-series visualization of pump prices, crude benchmarks, and forex going back to 2016, enabling trend analysis and seasonal pattern recognition. Provides context missing from point-in-time snapshots.

pricesvisualization

Station-level price comparison

Planned

Side-by-side price comparison across stations within a configurable radius, letting consumers find the cheapest fuel nearby. Drives accountability among oil companies and empowers consumer decision-making.

pricesconsumer

Weather disruption correlation

Planned

Overlay PAGASA typhoon tracks and historical weather events against fuel supply disruptions and price spikes to identify causal patterns. Feeds into early-warning models ahead of storm season.

weatherrisk
Phase 3

ASEAN Expansion

Scaling the intelligence layer across Southeast Asia

Malaysia fuel market integration

Future

Add Malaysian pump price data (RON 95, RON 97, diesel) from KPDNHEP alongside station mapping for Peninsular Malaysia, Sabah, and Sarawak. Enables cross-border price comparison with the Philippines.

expansionmalaysia

Indonesia fuel subsidy tracking

Future

Monitor Pertamina subsidized and non-subsidized fuel prices across Indonesian provinces, including subsidy reform events. Indonesia is the region's largest fuel consumer and a key benchmark for ASEAN energy policy.

expansionindonesia

Thailand PTT and regional refinery data

Future

Integrate PTT retail prices and Thailand's refinery throughput data, which serves as a major regional supply node. Adds a critical upstream data point for modeling ASEAN fuel availability.

expansionthailand

Malacca Strait ship tracking

Future

Real-time AIS vessel tracking for tankers transiting the Malacca Strait, the chokepoint through which ~80% of ASEAN seaborne oil imports pass. Provides early signals for supply tightness or disruption.

shippingreal-time

Cross-border price arbitrage analysis

Future

Algorithmic detection of price differentials between neighboring ASEAN markets that create arbitrage opportunities or fuel smuggling incentives. Useful for regulators and traders alike.

analysisprices
Phase 4

Global Energy Intelligence

Becoming the pandemic-tracker equivalent for global energy markets

Global chokepoint monitoring

Future

Real-time risk dashboards for the world's critical oil transit chokepoints — Strait of Hormuz, Suez Canal, Bab-el-Mandeb, and Malacca — integrating geopolitical alerts, vessel queues, and insurance rates.

geopoliticsrisk

OPEC production data feeds

Future

Automated ingestion of JODI and IEA monthly production statistics for OPEC and OPEC+ members, with quota compliance tracking and output deviation alerts. The supply side of the global oil equation.

supplydata

Refinery utilization dashboard

Future

Track global refinery capacity utilization, planned maintenance windows, and unplanned outages sourced from operator announcements and satellite imagery. Refinery tightness is a leading indicator for product price spikes.

supplyinfrastructure

Sanctions and trade flow mapping

Future

Visualize the rerouting of oil trade flows caused by sanctions regimes (Russia, Iran, Venezuela) and track dark-fleet tanker movements. Reveals shadow supply dynamics that official statistics miss.

geopoliticstrade

Multi-language support

Future

Localized UI in Filipino, Bahasa Indonesia, Thai, Vietnamese, and Malay to make the intelligence layer accessible to non-English-speaking users across ASEAN. Accessibility is a prerequisite for regional adoption.

i18naccessibility

Data Pipeline

Data Source Upgrades

Replacing derived and static data with authoritative, real-time sources. Each upgrade improves accuracy and reduces latency for downstream consumers.

Pump Prices

In Progress
Derived via import parity calculationDOE weekly CSV direct feed

Replaces estimated prices with official per-brand, per-region data — closing the accuracy gap for consumers and analysts.

Tanker Movements

Planned
Static shipping lane overlaysAIS real-time vessel tracking

Live tanker positions near Philippine ports will serve as a 5–10 day leading indicator for local fuel supply changes.

OPEC Production

Future
Not trackedJODI/IEA monthly production data

Adds the upstream supply dimension, enabling users to correlate OPEC output decisions with downstream pump price movements.

Refinery Status

Future
Static nameplate capacity dataMaintenance schedules and unplanned outage feeds

Refinery disruptions are among the fastest-moving drivers of product price premiums — real-time status data unlocks this signal.

Weather Impact

Planned
Not trackedPAGASA typhoon correlation engine

Historical correlation between typhoon tracks and supply disruptions will power predictive alerts ahead of storm season.

Station Details

Planned
OpenStreetMap community dataGoogle Places enrichment layer

Adds operating hours, ratings, photos, and amenity data, transforming raw coordinates into consumer-grade station profiles.

Open Source

Get Involved

The dashboard is open source. Pick an issue that matches your skill level and start contributing.

Add a new ASEAN country

advanced

Integrate pump price data, station locations, and a country-level map layer for a new ASEAN nation (Vietnam, Singapore, Cambodia, etc.). Requires sourcing data, mapping the ETL pipeline, and adding UI toggles.

expansiondata

Build a price alert system

intermediate

Create a notification system that lets users subscribe to price change alerts via email or browser push. Triggers when pump prices, Brent crude, or the PHP/USD rate cross user-defined thresholds.

featurenotifications

Add historical price charts

intermediate

Build time-series chart components for pump prices, crude benchmarks, and forex going back to 2016. Requires sourcing or scraping historical DOE data and integrating a charting library.

visualizationdata

Weather disruption overlay

intermediate

Add a PAGASA typhoon track overlay to the main map and build a correlation view showing how past storms affected fuel supply and prices. Includes fetching PAGASA advisory RSS feeds.

weathermapping

Improve mobile experience

beginner

Audit and improve the dashboard on small screens (375px–414px). Fix map controls, filter panels, and data tables for touch interaction. Good first issue for frontend contributors.

mobileux

Write integration tests

beginner

Add Playwright or Cypress integration tests covering the map load, scenario planner inputs, and news feed rendering. Helps prevent regressions as the codebase grows.

testingquality

Ready to contribute?

View on GitHub →

Read CLAUDE.md for coding conventions and project rules