How ladybug-w/worldmonitor works
World Monitor is a real-time global intelligence dashboard: users explore live geopolitical, economic, and infrastructure signals through maps, panels, and country briefs. The main flow runs from app startup and bootstrap hydration, through domain data services and API endpoints, to map and panel presentation. The repository also documents variant-specific dashboards, AI analysis, multilingual support, desktop/PWA delivery, and typed APIs. Several domain links below reflect README capabilities; sampled excerpts do not expose every runtime call, so uncertain connections are omitted or marked dashed.
Main entry points: App.ts Dashboard app · worldmonitor Domain services · search-manager.ts Search manager · country-intel.ts Country briefs
Components 21
Dashboard experience
- Dashboard app
src/App.ts - App context
src/app/app-context.ts - Map engines
src/components/MapContainer.ts - Dashboard panels
src/components/Panel.ts - Strategic posture
src/components/StrategicPosturePanel.ts - Search manager
src/app/search-manager.ts
Intelligence and analysis
- Country briefs
src/app/country-intel.ts - Country risk
src/services/country-instability.ts - Country geometry
src/services/country-geometry.ts - AI and ML
src/services/ml-worker.ts
Data and APIs
- News feeds
server/worldmonitor/news/v1 - Domain services
server/worldmonitor - API gateway
server/gateway.ts - API router
server/router.ts - Bootstrap data
api/bootstrap.js - Market history store
server/worldmonitor/market/v1/premium-stock-store.ts
Runtime and configuration
- Variant configuration
src/config/index.ts - API runtime
src/services/runtime.ts - Runtime settings
src/services/runtime-config.ts - Localization
src/services/i18n.ts
Other components
- Analyst
Connections 21
- Analyst → Dashboard app: explores
README.md - Dashboard app → App context: initializes
src/App.ts - Dashboard app → Bootstrap data: hydrates
src/App.ts - Dashboard app → Search manager: creates
src/App.ts - Dashboard app → Variant configuration: loads
src/App.ts - Dashboard app → API runtime: checks runtime
src/App.ts - Search manager → Country briefs: opens brief
src/app/search-manager.ts - Search manager → Map engines: changes layers
src/app/search-manager.ts - Country briefs → Country risk: uses scores
src/app/country-intel.ts - Country briefs → Country geometry: uses geometry
src/app/country-intel.ts - Dashboard panels → Strategic posture: includes
src/components/index.ts - Strategic posture → Domain services: presents signals
- Dashboard app → Map engines: presents layers
README.md - Dashboard app → Dashboard panels: presents intelligence
README.md - Dashboard app → AI and ML: supports AI analysis
README.md - Dashboard app → Localization: localizes
README.md - API runtime → Runtime settings: loads settings
src/services/runtime.ts - API gateway → API router: routes requests
- API router → Domain services: dispatches domains
- Domain services → News feeds: serves news
README.md - Domain services → Market history store: stores history