Methodology / Sources
How each signal
reaches the page.
Sources, refresh schedules, calculations, and the limits of a small public dashboard.
Refresh architecture
Static by design
Scheduled GitHub Actions fetch external data, write JSON into the repository, and commit only when the staged file changes. That commit triggers a Cloudflare Pages rebuild. API keys remain in GitHub Actions secrets and never reach the browser bundle.
- 01 Fetch at source
- 02 Validate and write JSON
- 03 Commit changed data
- 04 Rebuild static pages
Source register
What is measured
“Updated” stamps reflect the fetched_at field committed with each JSON dataset. A Pages rebuild preserves that timestamp.
Live signals
Egyptian business dayssources/Exchange Rates Historical.xlsx → data/dashboard.json
USD / EGP
A scheduled session submits the official historical-data form for US dollar observations. The dashboard uses the published selling rate and compares it with the preceding observation.
Central Bank of Egypt ↗Trading days, Sunday through Thursdaysources/EGX*.csv → data/dashboard.json
EGX 30, 70 EWI, and 100 EWI
A scheduled fetch downloads delayed historical index data after the market closes, with a separate latest-close fallback. Changes are versus the previous close.
Egyptian Exchange ↗Every three hoursdata/air-quality.json
Cairo air quality
AQI category bands follow the US AQI scale. PM2.5 and the dominant pollutant are passed through from the reporting station.
World Air Quality Index project ↗Dailydata/prayer-times.json
Prayer times and Hijri date
Cairo timings use calculation method 5, the Egyptian General Authority of Survey.
AlAdhan ↗Twice dailydata/gold-price.json
Gold
The XAU/EGP quote is converted from one troy ounce to grams. The 21K figure is 87.5% of the resulting 24K per-gram price.
GoldAPI ↗Every six hoursdata/earthquakes.json
Earthquakes
The query covers the prior 30 days inside 22–32°N and 25–35°E, spanning Egypt, Sinai, and the nearby Red Sea.
US Geological Survey ↗Dailydata/public-holiday.json
Next public holiday
The first item returned by the Egypt next-holiday endpoint is displayed.
Nager.Date ↗Prices and everyday essentials
Egyptian business days; source updates monthlysources/CPI- Monthly_.xls → data/dashboard.json
Urban consumer prices
The consolidated workbook is downloaded from its official media URL. All-items observations are chained across published base-year changes. See Adjustments below.
Central Bank of Egypt ↗Weeklydata/public-services.json
Weeklydata/public-services.json
Cairo Metro fares
Single-ride ticket tiers are read from the public fare page.
Mobility Cairo ↗Weeklydata/public-services.json
Residential electricity
Current and previous tariff links are discovered from the official navigation, then residential brackets are parsed in Egyptian piasters per kWh.
EgyptERA ↗Historical context
Weeklydata/public-services.json
Egyptian trading daysdata/world-bank.json → data/dashboard.json
Long-run annual indicators
Population, GDP per capita, life expectancy, internet use, urban population, CO₂ emissions, and modelled unemployment are retrieved from the World Bank API.
World Bank Data ↗Every 15 minutes while the page is openBrowser only
Cairo weather
This keyless masthead utility is currently requested directly by the browser and is not a dashboard data card.
Open-Meteo ↗Every 30 seconds while the page is openBrowser only
Adjustments
What the dashboard calculates
01CPI chaining
Monthly all-items observations are ordered and de-duplicated across fiscal-year sheets. Adjacent ratios between 0.75 and 1.25 are chained onto a continuous index starting at 100. A larger discontinuity is treated as a base-year reset and continuity is preserved for that month. Annual inflation compares the latest chained observation with the same month one year earlier.
02Gold conversion
The XAU/EGP spot quote is divided by 31.1034768 grams per troy ounce. The 21K estimate multiplies that 24K per-gram value by 0.875. It is a metal-value reference, not a retail quote, and excludes fabrication charges, dealer spreads, and taxes.
03Change windows
EGX percentage changes compare the latest index close with the preceding close. USD/EGP compares the latest published selling-rate observation with the preceding observation. Color is supplementary; every change also includes a plus or minus sign and a written comparison window.
04Historical markers
The November 2016 EGP flotation and March 2020 COVID-19 onset markers are static contextual annotations. They do not alter World Bank observations or imply that either event alone caused a series movement.
Reading the data
Important limits
- This is a personal dashboard, not an official Egyptian government publication.
- Source revisions may change historical values without notice.
- API and website availability can delay a scheduled refresh; the timestamp shows the last successful stored result.
- The currency converter is informational and excludes transaction costs.
- Archived MPED values reflect what appeared in each captured page, not a harmonized statistical release.