8000 worldmonitor/docs/features.mdx at main · amoghkini/worldmonitor · GitHub
[go: up one dir, main page]

Skip to content

Latest commit

 

History

History
770 lines (531 loc) · 43.3 KB

features.mdx

File metadata and controls

770 lines (531 loc) · 43.3 KB
title Features & Interface
description Complete guide to World Monitor features: interactive 3D globe, data layers, intelligence panels, market data, mobile UX, and keyboard shortcuts.

World Monitor provides a comprehensive set of features for real-time global intelligence monitoring, from interactive maps and data layers to market tracking and customizable panel layouts.

A family of derived datasets — physical-metals premiums and divergence, mineral production concentration, defense industrial base, demographics capability, food stocks, resilience indicators, commodity supply vulnerability, and the five-factor country scorecard — requires a Pro subscription on each supported surface. The Pro Intelligence Suite documents dashboard, REST, and MCP availability per dataset because not every dataset has every surface. Where a free account meets a supported dashboard surface, the section renders an upgrade card rather than an empty or failed state.

Interactive Global Map

  • Zoom & Pan - Smooth navigation with mouse/trackpad gestures
  • Regional Focus - named preset views for rapid navigation (Global, Americas, Europe, MENA, Asia, Latin America, Africa, Oceania)
  • Layer System - Toggle visibility of data layers organized by category
  • Time Filtering - Filter events by time range (1h, 6h, 24h, 48h, 7d)
  • Pinnable Map - Pin the map to the top while scrolling through panels, or let it scroll with the page
  • Smart Marker Clustering - Nearby markers group at low zoom, expand on zoom in

Marker Clustering

Dense regions with many data points use intelligent clustering to prevent visual clutter:

How It Works

  • Markers within a pixel radius (adaptive to zoom level) merge into cluster badges
  • Cluster badges show the count of grouped items
  • Clicking a cluster opens a popup listing all grouped items
  • Zooming in reduces cluster radius, eventually showing individual markers

Grouping Logic

  • Protests: Cluster within same country only (riots sorted first, high severity prioritized)
  • Tech HQs: Cluster within same city (Big Tech sorted before unicorns before public companies)
  • Tech Events: Cluster within same location (sorted by date, soonest first)

This prevents issues like Dubai and Riyadh companies appearing merged at global zoom, while still providing clean visualization at continental scales.

Data Layers

Layers are organized into logical groups for efficient monitoring:

Geopolitical

Layer Description
Conflicts Active conflict zones with involved parties and status
Hotspots Intelligence hotspots with activity levels based on news correlation
Sanctions Countries under economic sanctions regimes
Protests Live social unrest events from ACLED and GDELT
Armed Conflict Events UCDP georeferenced events, coloured by violence type and sized by deaths. Refreshed every 6 hours. Off by default
Middle East Strikes Strike reports from Telegram channels, classified and geocoded, with a GDELT backstop that requires multi-source reporting. State-media claims from a belligerent appear only when an independent source corroborates them within 2 hours. Shown only on deployments built with VITE_ENABLE_IRAN_ATTACKS=true and served with IRAN_EVENTS_ENABLED=true; Pro-only on desktop
Cyber Threats Threat-intelligence indicators by country, with severity. Shown only on deployments built with VITE_ENABLE_CYBER_LAYER=true. Off by default

Military & Strategic

Layer Description
Military Bases Global military installations from the authoritative base registry
Nuclear Facilities Power plants, weapons labs, enrichment sites
Gamma Irradiators IAEA-tracked Category 1-3 radiation sources
APT Groups State-sponsored cyber threat actors with geographic attribution
Spaceports 12 major launch facilities (NASA, SpaceX, Roscosmos, CNSA, ESA, ISRO, JAXA)
Critical Minerals Strategic mineral deposits (lithium, cobalt, rare earths) with operator info

Infrastructure

Layer Description
Undersea Cables 98 submarine cable routes worldwide
Pipelines 88 operating oil & gas pipelines across all continents
Internet Outages Network disruptions via Cloudflare Radar
AI Datacenters 313 AI compute clusters tracked from Epoch AI dataset

Transport

Layer Description
Ships (AIS) Live vessel tracking via AIS with chokepoint monitoring and the strategic-port registry*
Delays FAA airport delay status and ground stops
Aircraft emergencies Aircraft squawking 7500 (unlawful interference), 7600 (radio failure), or 7700 (general emergency) on adsb.lol, polled every 60 seconds. A marker appears only when the last message is at most 120 seconds old and the position at most 90 seconds old; older reports stay in the list for up to 15 minutes after the last observation. An aircraft that stops reporting becomes "unknown", never "resolved". Receiver coverage is incomplete. Flat map only. Off by default
Live Tanker Positions Tankers near six major chokepoints, from AIS. Energy variant only; see Energy Monitor

*AIS data via AISStream.io uses terrestrial receivers with stronger coverage in European/Atlantic waters. Middle East, Asia, and open ocean coverage is limited. Satellite AIS providers (Spire, Kpler) offer global coverage but require commercial licenses.

Canada

Layer Description
Canada Roads Road closures and incidents from Ontario, Alberta, and Manitoba 511, Toronto road restrictions, and DriveBC (Open511). Provinces whose API key is not configured keep their last good data. Off by default because the payload is large
Canada Alerts Public emergency alerts from Alberta Emergency Alert, B.C. Evacuation Orders, and SaskAlert, refreshed every 15 minutes. Polygons are drawn at their centroid. Ontario is not covered. On by default on desktop in the geopolitical variant

Natural Events

Layer Description
Natural USGS earthquakes (M4.5+) + NASA EONET events (storms, wildfires, volcanoes, floods)
Weather Official severe weather alerts (NWS, ECCC, WMO SWIC)
Water Levels One dot per reservoir or lake on the 50-entry Strategic Water Levels watchlist, coloured by status: red and amber for falling or low, blue for rising or high, grey for normal, and a hollow ring when there is no recent satellite pass or too little history to judge. Geopolitical and Energy variants. Off by default

Overlays & Labels

Layer Description
Day/Night Real-time solar terminator overlay showing day and night zones (updates every 5 minutes)
Economic Tabbed economic panel with FRED indicators, open public procurement opportunities, and USASpending.gov recent awards
Countries Country boundary labels
Waterways Strategic waterways and chokepoints
Trade Routes 19 global trade routes (container, energy, bulk) with multi-segment arcs through strategic chokepoints
Fires (FIRMS) NASA FIRMS satellite fire detection (VIIRS thermal hotspots) for wildfire and operational risk monitoring

Webcams

Layer Description
Live Webcams Registry-backed streams across geopolitical regions with automatic fallback handling

Intelligence Panels

Beyond raw data feeds, the dashboard provides synthesized intelligence panels:

Panel Purpose
AI Strategic Posture Theater-level military aggregation with strike capability analysis
Strategic Risk Overview Composite risk score combining all intelligence modules
Country Instability Index Real-time CII v14 stability scores and signed 24-hour movement deltas for 31 Tier-1 countries
Infrastructure Cascade Dependency analysis for cables, pipelines, and chokepoints
Live Intelligence GDELT-powered topic feeds (Military, Cyber, Nuclear, Sanctions)
Intel Feed Curated defense and security news sources
Country Brief AI-generated country profiles with key indicators, risk factors, and recent developments
Aviation Intelligence 6-tab aviation panel (Ops, Flights, Airlines, Tracking, News, Prices) with NOTAM closure detection across the registered airport watchlist
Climate Anomalies Temperature and precipitation deviations across 15 zones using Open-Meteo ERA5 data against rolling baselines
Strategic Water Levels Water-surface level of 50 reservoirs and lakes that matter for hydropower, irrigation, shipping and transboundary water disputes, from NASA ICESat-2 lidar. Records and fast moves sort first. Each row shows the status, the level against the usual for that month (or the 12-month change), a level sparkline and the date of the last satellite pass, with All, Needs attention and Transboundary filters. Selecting a row opens it on the map. Level only, not storage volume; NASA publishes each pass 50 to 70 days after it is measured. On by default in the Energy variant, opt-in in the geopolitical variant. See Strategic Water Levels
Displacement Tracking UNHCR refugee, asylum seeker, and IDP data by origin and host country, IDMC new internal displacement events, IOM DTM internal displacement by region, and source-dated cross-border movements (UNHCR portal, UK Home Office, US CBP, Frontex, Panama)
Gulf Economies Indices, currencies, and oil data for 6 GCC countries (Saudi, UAE, Qatar, Kuwait, Bahrain, Oman)
WTO Trade Policy Active trade restrictions, tariff trends, bilateral trade flows, and SPS/TBT barriers
Central Banks, BIS & IMF Policy-rate and institutional finance signals from central-bank and supranational finance institutions
Market Watchlist User-defined stock/commodity/crypto symbol lists (up to 50 symbols)

These panels transform raw signals into actionable intelligence by applying scoring algorithms, trend detection, and cross-source correlation.

News Aggregation

Multi-source RSS aggregation across categories:

  • World / Geopolitical - BBC, Reuters, AP, Guardian, NPR, Politico, The Diplomat
  • Middle East / MENA - Al Jazeera, BBC ME, Guardian ME, Al Arabiya, Times of Israel
  • Africa - BBC Africa, News24, Google News aggregation (regional & Sahel coverage)
  • Latin America - BBC Latin America, Guardian Americas, Google News aggregation
  • Asia-Pacific - BBC Asia, South China Morning Post, Google News aggregation
  • Energy & Resources - Google News aggregation (oil/gas, nuclear, mining, Reuters Energy)
  • Technology - Hacker News, Ars Technica, The Verge, MIT Tech Review
  • AI / ML - ArXiv, VentureBeat AI, The Verge AI, MIT Tech Review
  • Finance - CNBC, MarketWatch, Financial Times, Yahoo Finance
  • Government - White House, State Dept, Pentagon, Treasury, Fed, SEC, UN News, CISA
  • Intel Feed - Defense One, Breaking Defense, Bellingcat, Krebs Security, Janes
  • Think Tanks - Foreign Policy, Atlantic Council, Foreign Affairs, CSIS, RAND, Brookings, Carnegie
  • Crisis Watch - International Crisis Group, IAEA, WHO, UNHCR
  • Regional Sources - Xinhua, TASS, Kyiv Independent, Moscow Times
  • Layoffs Tracker - Tech industry job cuts

Source Filtering

The SOURCES button in the header opens a global source management modal, enabling fine-grained control over which news sources appear in the dashboard.

Capabilities:

  • Search: Filter the source list by name to quickly find specific outlets
  • Individual Toggle: Click any source to enable/disable it
  • Bulk Actions: "Select All" and "Select None" for quick adjustments
  • Counter Display: Shows "45/77 enabled" to indicate current selection
  • Persistence: Settings are saved to localStorage and persist across sessions

Use Cases:

  • Noise Reduction: Disable high-volume aggregators (Google News) to focus on primary sources
  • Regional Focus: Enable only sources relevant to a specific geographic area
  • Source Quality: Disable sources with poor signal-to-noise ratio
  • Bias Management: Balance coverage by enabling/disabling sources with known editorial perspectives

Technical Details:

  • Disabled sources are filtered at fetch time (not display time), reducing bandwidth and API calls
  • Affects all news panels simultaneously: disable BBC once, it is gone everywhere
  • Panels with all sources disabled show "All sources disabled" message
  • Changes take effect on the next refresh cycle

Regional Intelligence Panels

Dedicated panels provide focused coverage for strategically significant regions:

Panel Coverage Key Topics
Middle East MENA region Israel-Gaza, Iran, Gulf states, Red Sea
Africa Sub-Saharan Africa Sahel instability, coups, insurgencies, resources
Latin America Central & South America Venezuela, drug trafficking, regional politics
Asia-Pacific East & Southeast Asia China-Taiwan, Korean peninsula, ASEAN
Energy & Resources Global Oil markets, nuclear, mining, energy security

Each panel aggregates region-specific sources to provide concentrated situational awareness for that theater. This enables focused monitoring when global events warrant attention to a particular region.

Live News Streams

Live streams from major news networks with channel switching:

Channel Coverage
Bloomberg Business & financial news
Sky News UK & international news
Euronews European perspective
DW News German international broadcaster
France 24 French global news
Al Arabiya Middle East news (Arabic perspective)
Al Jazeera Middle East & international news

Core Features:

  • Channel Switcher - One-click switching between networks
  • Live Indicator - Blinking dot shows stream status, click to pause/play
  • Mute Toggle - Audio control (muted by default)
  • Double-Width Panel - Larger video player for better viewing

Verified live playback:

Each channel tries its sources in order: the broadcaster's own HLS stream where one exists, then verified YouTube live streams played through the official YouTube IFrame Player API. A channel counts as live only after the player or the stream playlist confirms it:

Situation What the panel shows
Connecting A "Connecting to…" cover until the stream is confirmed live
Ended, deleted or unembeddable stream The next source; when none is left, a card that says why, with Retry, Play next channel and Open on YouTube
Automatic start (play-all, auto-play, Resume) Skips a channel that is offline and plays the next one, without changing the saved channel
Player signals blocked (extensions, strict tracking protection) The stream keeps playing with a "Can’t confirm this stream is live" note

Streams are listed in src/config/live-video-sources.ts; npm run live-video:check -- --all reports any that stopped being live. A daily audit keeps one GitHub issue, "Live video sources: slots needing a replacement", that names each webcam or channel slot with nothing live, where it shows and why; maintainers check a replacement URL with npm run live-video:check -- <url> and paste it into that file. YouTube refuses embeds from GitHub's runners, so the audit plays YouTube entries through the residential proxy in the LIVE_VIDEO_AUDIT_PROXY_URL secret and stops with an error when that secret is missing. For a channel entry, the audit first reads the channel's /live page through the same proxy and checks the video the channel has live right now instead of the channel embed; when a pinned video ahead of the channel has died, the issue suggests that live video under "Live now", ready to paste. A scheduled job reads the same channel pages and publishes the video each channel has live (the liveVideoResolved on-demand bootstrap key). When a viewer plays a slot that lists a channel, the player tries that video immediately before the channel entry, so sources listed ahead of the channel keep priority; it plays the listed sources unchanged when the video is missing, older than 36 hours, or not available within 1.5 seconds. A failure the runner cannot tell apart from its own location or network, such as a region-locked channel refused outside its regions or an HLS playlist that a CDN edge kept serving unchanged, is listed under "Could not verify from the runner" instead of as a slot needing a replacement.

Idle Detection:

To conserve resources, playback stops in two cases:

Trigger Action
Tab hidden Stream stops (via Visibility API)
No mouse, keyboard or touch activity Stream stops after the idle time chosen in Settings › Media (one hour by default, or never) and shows a notice with Resume
Viewer paused the stream Left alone; the idle stop never overrides a manual pause

Market Data

  • Stocks - Major indices and tech stocks via Finnhub (Yahoo Finance backup)
  • Commodities - Oil, gold, natural gas, copper, VIX
  • Crypto - Bitcoin, Ethereum, Solana via CoinGecko
  • Sector Heatmap - Visual sector performance (11 SPDR sectors)
  • Economic Indicators - Fed data via FRED (assets, rates, yields)
  • Oil Analytics - EIA data: WTI/Brent prices, US production, US inventory with weekly changes
  • Government Spending - USASpending.gov: Recent federal contracts and awards

Prediction Markets

  • Polymarket integration for event probability tracking
  • Correlation analysis with news events

Workflows

Two full-screen, keyboard-first workflows complement the map + panels experience:

  • Route Explorer — plan a shipment between any two countries. Four tabs (Current / Alternatives / Land / Impact) resolve chokepoint exposure, bypass corridors, land alternatives, and per-country import exposure for the selected HS2 commodity. PRO-gated.
  • Scenario Engine — run pre-built disruption scenarios (conflict, weather, sanctions, tariff shocks) and watch the impact resolve across chokepoints, sectors, and countries on the map and in the Supply Chain panel. PRO-gated.

Country-level risk

Two complementary country-scoring surfaces:

  • Country Instability Index — a high-frequency CII v14 stress score with signed 24-hour movement deltas, blending unrest, conflict, security, and information signals for 31 Tier-1 countries.
  • Country Resilience Index — a 0-100 resilience score for the 196-country public rankable universe built from 72 indicators across 21 active dimensions and 6 domains. Live API scores refresh every 6 hours. Crawlable country snapshots publish monthly with their capture date and revision note.

CII and CRI answer different questions and are not interchangeable: CII is short-horizon stress; CRI is structural resilience plus live shock exposure.

Search (Cmd+K)

Universal command palette for navigating the entire application. Every panel, map view, layer toggle, workflow, and country brief is searchable:

The full panel inventory lives in the app itself — Cmd+K surfaces what's available in your current variant rather than a fixed list.

Data Export

  • Dashboard data export — CSV, JSON, and PDF reports of the current dashboard state — on plans that include data export (Pro Business, the API plans, and Enterprise); see Plans & Pricing
  • Country dossier evidence bundles as portable Markdown with source links and freshness notes where available (Pro and above)
  • Historical playback from snapshots

Dashboard tabs and sharing

Dashboard tabs are capped per plan: 3 on Free, 10 on Pro, 25 on Pro Business. The cap applies when you create a tab. Existing tabs keep working if your plan changes.

The ▾ button next to + sets what new tabs start with: Use this tab's panels saves the current tab's shown and hidden panels and their order, and Use the default panels returns new tabs to the built-in set.

To share a map position and its layers, copy the browser URL. See Shareable links for the included settings. A map link does not share your dashboard's panel layout or grant paid access.

Team dashboards

Team dashboards share a tab's panel layout and map settings with signed-in teammates. API Business owners and accepted members of their Pro seats have access while the subscription covers them. Enterprise members need an active membership and a current contract.

Only one team is available at a time. World Monitor selects your eligible Enterprise account first, then your own API Business subscription, then an accepted seat on another owner's API Business subscription. If your Enterprise account or own subscription takes priority, you will not see the inviting team's dashboards. If no higher-priority team applies and several accepted seats qualify, World Monitor selects the first eligible seat it finds. Other inviting teams' dashboards are unavailable.

Standalone Pro, Pro Business, and API Starter subscriptions do not create a team. The 25 custom dashboards on Pro Business are personal tabs, not 25 shared team dashboards. See Plans & Pricing.

Share a dashboard with your team

  1. Sign in with your own account that belongs to the team.
  2. Open the tab you want to share.
  3. Arrange its panels and map settings.
  4. Click Team next to the dashboard tabs.
  5. Click Share this tab with your team.

The dashboard appears in your team's list under the tab's name. It includes panel order, visibility, docking, and sizes, plus the map view, zoom, center, time range, and layers. Custom widgets and MCP panels are excluded. Sharing copies the layout, not a snapshot of the data or the publisher's credentials. Each member's own access determines which paid data they can view.

Open and update a team dashboard

  1. Click Team in the same dashboard variant as your teammate.
  2. Click the shared dashboard's name.

The dashboard opens as a new tab. If it is already open, World Monitor switches to that tab. Your personal tab limit still applies when opening a new tab.

Your changes are not published to teammates until you click Team, then Share this tab's changes with your team. Use Get the latest version to apply a newer shared layout. This replaces the tab's panel layout, including any unpublished local panel edits.

Opening a team dashboard as a new tab or getting its latest version also applies its map settings to the browser's current map. Map settings are shared across tabs. Switching tabs restores panel state but does not restore the previous map. Panel sizes also apply to those panels in other tabs in the same browser.

If another member publishes after your Team list was last loaded, sharing reports a conflict and refreshes the list. Once the list refreshes, sharing your older local layout can overwrite the teammate's newer layout without another conflict warning. Save any local work you need, then use Get the latest version and review it before publishing further changes.

Stop sharing a dashboard

  1. Click Team.
  2. Click the remove button beside the dashboard, labelled Stop sharing followed by its name.
  3. Confirm the removal.

The dashboard leaves the team's list. Tabs that members already opened remain available.

Every team member can publish, update, or stop sharing any dashboard in that team. Each team can share up to 25 dashboards per dashboard variant. At that limit, stop sharing an existing dashboard before publishing another.

If Team is missing, check that you are signed in with an accepted API Business seat or an active Enterprise membership. An API Business owner also needs a current subscription. A standalone paid subscription does not grant team membership.


Custom Monitors

Create personalized keyword alerts that scan all incoming news:

  1. Enter comma-separated keywords (e.g., "nvidia, gpu, chip shortage")
  2. System assigns a unique color
  3. Matching articles are highlighted in the Monitor panel
  4. Matching articles in clusters inherit the monitor color

Monitors persist across sessions via LocalStorage.


Activity Tracking

The dashboard highlights newly-arrived items so you can quickly identify what changed since your last look.

Visual Indicators

Indicator Duration Purpose
NEW tag 2 minutes Badge on items that just appeared
Glow highlight 30 seconds Subtle animation drawing attention
Panel badge Until viewed Count of new items in collapsed panels

Automatic "Seen" Detection

The system uses IntersectionObserver to detect when panels become visible:

  • When a panel is >50% visible for >500ms, items are marked as "seen"
  • Scrolling through a panel marks visible items progressively
  • Switching panels resets the "new" state appropriately

Panel-Specific Tracking

Each panel maintains independent activity state:

  • News: New clusters since last view
  • Markets: Price changes exceeding thresholds
  • Predictions: Probability shifts >5%
  • Natural Events: New earthquakes and EONET events

This enables focused monitoring: you can collapse panels you have reviewed and see at a glance which have new activity.


Snapshot System

The dashboard captures periodic snapshots for historical analysis:

  • Automatic capture every refresh cycle
  • 7-day retention with automatic cleanup
  • Stored data: news clusters, market prices, prediction values, hotspot levels
  • Playback: Load historical snapshots to see past dashboard states

Baselines (7-day and 30-day averages) are stored in IndexedDB for deviation analysis.


Critical Mineral Deposits

The Minerals layer displays strategic mineral extraction sites essential for modern technology and defense supply chains.

Tracked Resources

Mineral Strategic Importance Major Producers
Lithium EV batteries, energy storage Australia, Chile, China
Cobalt Battery cathodes, superalloys DRC (60%+ global), Australia
Rare Earths Magnets, electronics, defense China (60%+ global), Australia, USA

Key Sites

Site Mineral Country Significance
Greenbushes Lithium Australia World's largest hard-rock lithium mine
Salar de Atacama Lithium Chile Largest brine lithium source
Mutanda Cobalt DRC World's largest cobalt mine
Tenke Fungurume Cobalt DRC Major Chinese-owned cobalt source
Bayan Obo Rare Earths China 45% of global REE production
Mountain Pass Rare Earths USA Only active US rare earth mine

Supply Chain Risks

Critical minerals are geopolitically concentrated:

  • Cobalt: 70% from DRC, significant artisanal mining concerns
  • Rare Earths: 60% from China, processing nearly monopolized
  • Lithium: Expanding production but demand outpacing supply

News about these regions or mining companies can signal supply disruptions affecting technology and defense sectors.


Cyber Threat Actors (APT Groups)

The map displays geographic attribution markers for major state-sponsored Advanced Persistent Threat (APT) groups. These markers show the approximate operational centers of known threat actors.

Tracked Groups

Group Aliases Sponsor Notable Activity
APT28/29 Fancy Bear, Cozy Bear Russia (GRU/FSB) Election interference, government espionage
APT41 Double Dragon China (MSS) Supply chain attacks, intellectual property theft
Lazarus Hidden Cobra North Korea (RGB) Financial theft, cryptocurrency heists
APT33/35 Elfin, Charming Kitten Iran (IRGC) Critical infrastructure, aerospace targeting

Why This Matters

Cyber operations often correlate with geopolitical tensions. When news reports reference Russian cyber activity during a Ukraine escalation, or Iranian hacking during Middle East tensions, these markers provide geographic context for the threat landscape.

Visual Indicators

APT markers appear as warning triangles with distinct styling. Clicking a marker shows:

  • Official designation and common aliases
  • State sponsor and intelligence agency
  • Primary targeting sectors

Social Unrest Tracking

The Protests layer aggregates civil unrest data from two independent sources, providing corroboration and global coverage.

ACLED (Armed Conflict Location & Event Data)

Academic-grade conflict data with human-verified events:

  • Coverage: Global, 30-day rolling window
  • Event types: Protests, riots, strikes, demonstrations
  • Metadata: Actors involved, fatalities, detailed notes
  • Confidence: High (human-curated)

GDELT (Global Database of Events, Language, and Tone)

Real-time news-derived event data:

  • Coverage: Global, 7-day rolling window
  • Event types: Geocoded protest mentions from news
  • Volume: Reports per location (signal strength)
  • Confidence: Medium (algorithmic extraction)

Multi-Source Corroboration

Events from both sources are deduplicated using a 0.5 degree spatial grid and date matching. When both ACLED and GDELT report events in the same area:

  • Confidence is elevated to "high"
  • ACLED data takes precedence (higher accuracy)
  • Source list shows corroboration

Severity Classification

Severity Criteria
High Fatalities reported, riots, or clashes
Medium Large demonstrations, strikes
Low Smaller protests, localized events

Events near intelligence hotspots are cross-referenced to provide geopolitical context.

Map Display Filtering

To reduce visual clutter and focus attention on significant events, the map displays only high-severity protests and riots:

Displayed Event Type Visual
Yes Riot Bright red marker
Yes High-severity protest Red marker
No Medium/low-severity protest Not shown on map

Lower-severity events are still tracked for CII scoring and data exports: they simply do not create map markers. This filtering prevents dense urban areas (which naturally generate more low-severity demonstrations) from overwhelming the map display.


Aviation Monitoring

The Flights layer tracks airport delays and ground stops at major US airports using FAA NASSTATUS data.

Delay Types

Type Description
Ground Stop No departures permitted; severe disruption
Ground Delay Departures held; arrival rate limiting
Arrival Delay Inbound traffic backed up
Departure Delay Outbound traffic delayed

Severity Thresholds

Severity Average Delay Visual
Severe ≥60 minutes Red
Major 45-59 minutes Orange
Moderate 25-44 minutes Yellow
Minor 15-24 minutes Gray

Monitored Airports

Airports in the global registry span the Americas, Europe, Asia-Pacific, MENA, and Africa and are monitored through three independent data sources (FAA ASWS, AviationStack, ICAO NOTAM):

  • Major US hubs: JFK, LAX, ORD, ATL, DFW, DEN, SFO
  • International gateways with high traffic volume
  • 46 MENA airports via ICAO NOTAM for closure detection
  • Airports frequently affected by weather or congestion

Ground stops are particularly significant: they indicate severe disruption (weather, security, or infrastructure failure) and can cascade across the network.


Prediction Market Filtering

The Prediction Markets panel focuses on geopolitically relevant markets, filtering out sports and entertainment.

Inclusion Keywords

Markets matching these topics are displayed:

  • Conflicts: war, military, invasion, ceasefire, NATO, nuclear
  • Countries: Russia, Ukraine, China, Taiwan, Iran, Israel, Gaza
  • Leaders: Putin, Zelensky, Trump, Biden, Xi Jinping, Netanyahu
  • Economics: Fed, interest rate, inflation, recession, tariffs, sanctions
  • Global: UN, EU, treaties, summits, coups, refugees

Exclusion Keywords

Markets matching these are filtered out:

  • Sports: NBA, NFL, FIFA, World Cup, championships, playoffs
  • Entertainment: Oscars, movies, celebrities, TikTok, streaming

This ensures the panel shows markets like "Will Russia withdraw from Ukraine?" rather than "Will the Lakers win the championship?"


Panel Management

The dashboard organizes data into draggable, collapsible panels that persist user preferences across sessions.

Drag-to-Reorder

Panels can be reorganized by dragging:

  1. Grab the panel header (grip icon appears on hover)
  2. Drag to desired position
  3. Drop to reorder
  4. New order saves automatically to LocalStorage

This enables personalized layouts: put your most-watched panels at the top.

Keyboard users reorder with the ⇅ move button at the start of each panel header. The button stays visually hidden until it receives focus. Arrow keys move the panel one slot at a time. When the viewport is at least 900px wide and the map is shown, Page Up moves the panel to the sidebar grid and Page Down moves it to the grid below the map.

Panel Resizing

Each panel has a resize handle on its bottom edge (height) and its right edge (width):

  • Height: drag the bottom handle to span 1 to 4 grid rows
  • Width: drag the right handle to span up to 3 grid columns, limited by how many columns the grid currently has
  • Keyboard: focus a handle and use the arrow keys, or Home and End for the minimum and maximum
  • Reset: double-click a handle to restore that panel's default height or width

Map Width Divider

When the viewport is at least 900px wide, the map and the panel grid sit side by side with a vertical divider between them. Drag the divider to change the map's share of the width, or focus it and press the Left and Right arrow keys to move it in 5% steps. The map keeps a minimum width, and so does the panel column.

Panel Text Size

The Panel text size option on the Settings tab sets text size for every panel. On the Panels tab, the Text size selector next to a panel overrides it for that panel after you click Save. Use global returns the panel to the global size.

Reset Layout

Reset Layout on the Panels tab of Settings clears panel order, row and column spans, per-panel text sizes, map height, map width, and map side, then reloads the page.

Panel Visibility

Toggle panels on/off via the Settings menu:

  • Hidden panels: Do not render, do not fetch data
  • Visible panels: Full functionality
  • Collapsed panels: Header only, data still refreshes

Hiding a panel is different from disabling a layer: the panel itself does not appear in the interface.

Default Panel Order

Panels are organized by intelligence priority:

Priority Panels Purpose
Critical Strategic Risk, Live Intel Immediate situational awareness
Primary News, CII, Markets Core monitoring data
Supporting Predictions, Economic, Monitor Supplementary analysis
Reference Live News Video Background context

Persistence

Panel state survives browser restarts:

  • LocalStorage: Panel order, visibility, collapsed state, row and column spans, per-panel text size, map width, map height, and map side
  • Automatic save: Drag, keyboard, and resize changes persist immediately; Panels tab changes persist when you click Save
  • Per-device by default: Web builds with VITE_CLOUD_PREFS_ENABLED=true sync panel order, visibility, spans, and per-panel text size for signed-in users. Collapsed state, map width, map height, and map side always stay on the device.

Mobile Experience

The dashboard is optimized for mobile devices with a streamlined interface that prioritizes usability on smaller screens.

First-Time Mobile Welcome

When accessing the dashboard on a mobile device for the first time, a welcome modal explains the mobile-optimized experience:

  • Simplified view notice - Informs users they are seeing a curated mobile version
  • Navigation tip - Explains regional view buttons and marker interaction
  • "Don't show again" option - Checkbox to skip on future visits (persisted to localStorage)

Mobile-First Design

On screens narrower than 768px or touch devices:

  • Compact map - Reduced height (40vh) to show more panels
  • Single-column layout - Panels stack vertically for easy scrolling
  • Hidden map labels - All marker labels are hidden to reduce visual clutter
  • Fixed layer set - Layer toggle buttons are hidden; a curated set of layers is enabled by default
  • Simplified controls - Map resize handle and pin button are hidden
  • Touch-optimized markers - Expanded touch targets (44px) for easy tapping
  • Hidden DEFCON indicator - Pentagon Pizza Index hidden to reduce header clutter
  • Hidden FOCUS selector - Regional focus buttons hidden (use preset views instead)
  • Compact header - Social link shows X logo instead of username text

Mobile Default Layers

The mobile experience focuses on the most essential intelligence layers:

Layer Purpose
Conflicts Active conflict zones
Hotspots Intelligence hotspots with activity levels
Sanctions Countries under economic sanctions
Outages Network disruptions
Natural Earthquakes, storms, wildfires
Weather Severe weather warnings

Layers disabled by default on mobile (but available on desktop):

  • Military bases, nuclear facilities, spaceports, minerals
  • Undersea cables, pipelines, datacenters
  • AIS vessels, military flights
  • Protests, economic centers

This curated set provides situational awareness without overwhelming the interface or consuming excessive data/battery.


Offline ML Capabilities

The dashboard includes browser-side machine learning that works without any server connection:

  • Threat Classification - Three-stage pipeline (keyword pre-filter, browser ML model, optional LLM refinement) classifies news headlines by threat category
  • Headline Scoring - ML-based importance scoring for news articles, enabling priority-based rendering
  • Entity Extraction - Client-side named entity recognition for identifying countries, organizations, and key figures in headlines

These models run entirely in the browser via Web Workers, providing intelligence analysis capabilities even when offline or when API keys are not configured.


Usage

Keyboard Shortcuts

  • Cmd+K / Ctrl+K - Open search
  • Up/Down - Navigate search results
  • Enter - Select result
  • Esc - Close modals

Map Controls

  • Scroll - Zoom in/out
  • Drag - Pan the map
  • Click markers - Show detailed popup with full context
  • Hover markers - Show tooltip with summary information
  • Layer toggles - Show/hide data layers
  • Layer explanations - Open compact cards from the layer picker to see a layer's purpose, source/provider, freshness expectation, confidence notes, limitations, and related panels

Map Marker Design

Infrastructure markers (nuclear facilities, economic centers, ports) display without labels to reduce visual clutter. Full information is available through interaction:

Layer Label Behavior Interaction
Nuclear facilities Hidden Click for popover with details
Economic centers Hidden Click for popover with details
Protests Hidden Hover for tooltip, click for details
Military bases Hidden Click for popover with base info
Hotspots Visible Color-coded activity levels
Conflicts Visible Status and involved parties

This design prioritizes geographic awareness over label density: users can quickly scan for markers and then interact for context.

Panel Management

  • Drag panels - Reorder layout
  • Settings - Toggle panel visibility

Shareable Links

The current view state is encoded in the URL, enabling:

  • Bookmarking: Save specific views for quick access
  • Sharing: Send colleagues a link to your exact map position and layer configuration
  • Deep linking: Link directly to a specific region or feature

Encoded Parameters:

Parameter Description
lat, lon Map center coordinates
zoom Zoom level (1-10)
time Active time filter (1h, 6h, 24h, 7d)
view Preset view (global, us, mena)
layers Comma-separated enabled layer IDs

Example: ?lat=38.9&lon=-77&zoom=6&layers=bases,conflicts,hotspots

Values are validated and clamped to prevent invalid states.

0