How domenicoverde/vowifi-map works
vowifi-map scans mobile operators’ public ePDG endpoints and presents the resulting availability and locations on an interactive map. The backend loads operator data, performs DNS/IP-location/IKE checks, and writes a JSON report; the frontend loads that report and renders map markers, details, statistics, and theme controls. Backend stage ordering is documented in the README, but the sampled excerpts do not show the scanner’s internal calls, so those links cite the README. Protocol modules are included, though their internal relationships are not established by the excerpts.
Main entry points: App.tsx Frontend app · main.go Scanner CLI · scan.go Scan coordinator · MapView.tsx Interactive map
Components 23
Backend scanning
- Operator catalog
backend/src/internal/persistence/csv.go - GeoIP lookup
backend/src/internal/persistence/geoip.go - Scan coordinator
backend/src/internal/scan/scan.go - DNS resolution
backend/src/internal/scan/dns.go - IKE probe
backend/src/internal/scan/ike.go - Scan data types
backend/src/internal/scan/types.go - Scanner CLI
backend/src/cmd/main.go
IKEv2 protocol
- IKE message build
backend/src/internal/ike/build.go - IKE message codec
backend/src/internal/ike/message.go - IKE request
backend/src/internal/ike/request.go - IKE security
backend/src/internal/ike/security.go - IKE types
backend/src/internal/ike/types.go
Interactive map
- Frontend app
frontend/src/App.tsx - Map summary
frontend/src/components/Header.tsx - Interactive map
frontend/src/components/MapView.tsx - ePDG details
frontend/src/components/EpdgPopup.tsx - Status markers
frontend/src/markerIcon.ts - Country flags
frontend/src/flagEmoji.ts - Theme control
frontend/src/components/ThemeToggle.tsx - Theme state
frontend/src/useTheme.ts - Browser entry
frontend/src/main.tsx
Other components
- JSON report
- Map visitor
Connections 17
- Scanner CLI → Operator catalog: loads operators
backend/src/cmd/main.go - Scanner CLI → GeoIP lookup: opens database
backend/src/cmd/main.go - Scanner CLI → Scan coordinator: scans operators
backend/src/cmd/main.go - Scan coordinator → DNS resolution: resolves hostnames
README.md - Scan coordinator → GeoIP lookup: geolocates IPs
README.md - Scan coordinator → IKE probe: probes endpoints
README.md - Scanner CLI → JSON report: writes JSON
backend/src/cmd/main.go - Map visitor → Browser entry: opens app
- Browser entry → Frontend app: renders
frontend/src/main.tsx - Frontend app → JSON report: fetches markers
frontend/src/App.tsx - Frontend app → Map summary: renders summary
frontend/src/App.tsx - Frontend app → Interactive map: renders markers
frontend/src/App.tsx - Frontend app → Theme control: renders control
frontend/src/App.tsx - Frontend app → Theme state: uses theme
frontend/src/App.tsx - Interactive map → ePDG details: renders details
frontend/src/components/MapView.tsx - Interactive map → Status markers: selects icons
frontend/src/components/MapView.tsx - ePDG details → Country flags: formats flag
frontend/src/components/EpdgPopup.tsx