Skip to Content
APP • YONDA-ARCHITECTURE

Mobile App Architecture

The `yonda-app` client is built with Flutter to target iOS, Android, and Apple CarPlay / Android Auto dashboards.

Blake Carter|Version v3.0.0|CANONICAL

Architectural Layers

  1. Location Streamer: Interfaces with OS native geolocation services (geolocator / flutter_background_geolocation) in foreground and background.
  2. Geofence Evaluation Engine: Computes Haversine distance against pre-cached POI coordinate boundaries with a default radius of 350m.
  3. Audio-Loom Controller: Multiplexes between primary spoken narrative (Device TTS or streamed ElevenLabs audio), background ambient loop (e.g., wind, acoustic guitar), and sound FX cues.
  4. Voice Activity Detector (VAD): Passive microphone listener for passenger intent triggers.