How duckduckgo/android works
DuckDuckGo Android is a consumer browser app with privacy-protection features and supporting services. A typical user journey is to browse a site, where browser state and web storage are managed alongside protections; users can also configure app-tracking protection, use Duck.ai, run personal-information-removal scans, and manage subscription-related prompts. The graph emphasizes these product areas and their visible runtime links. Several subsystems are represented by directory-level nodes because their implementation files were not sampled; those links are omitted rather than inferred.
Main entry points: WebLocalStorageManager.kt Web local storage · ManageRecentAppsProtectionActivity.kt Recent app controls · PirForegroundScanService.kt PIR scan service · DuckAiNativeStorageJsMessageHandler.kt Duck.ai JS bridge
Components 19
Browser experience
- WebView sessions
app/src/main/java/com/duckduckgo/app/browser/session/WebViewSessionStorage.kt - Web local storage
app/src/main/java/com/duckduckgo/app/browser/weblocalstorage/WebLocalStorageManager.kt - Storage settings parser
app/src/main/java/com/duckduckgo/app/browser/weblocalstorage/WebLocalStorageSettingsJsonParser.kt
Privacy protections
- Recent app controls
app-tracking-protection/vpn-impl/src/main/java/com/duckduckgo/mobile/android/vpn/apps/ui/ManageRecentAppsProtectionActivity.kt - App protection state
app-tracking-protection/vpn-impl/src/main/java/com/duckduckgo/mobile/android/vpn/apps/ManageAppsProtectionViewModel.kt - Tracking protection VPN
app-tracking-protection/vpn-impl/src/main/java/com/duckduckgo/mobile/android/vpn/service/TrackerBlockingVpnService.kt - PIR scan service
pir/pir-impl/src/main/java/com/duckduckgo/pir/impl/scan/PirForegroundScanService.kt - PIR job runner
pir/pir-impl/src/main/java/com/duckduckgo/pir/impl/scheduling - PIR opt-out
pir/pir-impl/src/main/java/com/duckduckgo/pir/impl/optout
Duck.ai
- Duck.ai JS bridge
duckchat/duckchat-store/src/main/java/com/duckduckgo/duckchat/store/impl/handler/DuckAiNativeStorageJsMessageHandler.kt - Duck.ai bridge storage
duckchat/duckchat-store/src/main/java/com/duckduckgo/duckchat/store/impl/DuckAiBridgeStorage.kt
App services
- VPN controller API
network-protection/network-protection-impl/src/main/java/com/duckduckgo/networkprotection/impl/configuration/WgVpnControllerService.kt - Download manager
downloads/downloads-impl/src/main/java/com/duckduckgo/downloads/impl/UrlFileDownloadCallManager.kt - Persistent storage API
persistent-storage/persistent-storage-api/src/main/java/com/duckduckgo/persistentstorage/api/PersistentStorage.kt - Persistent storage
persistent-storage/persistent-storage-impl/src/main/java/com/duckduckgo/persistentstorage/impl/RealPersistentStorage.kt
Subscription metrics
- Paywall metrics
subscriptions/subscriptions-impl/src/main/java/com/duckduckgo/subscriptions/impl/pixels/PaywallMetricsManager.kt - Paywall metrics store
subscriptions/subscriptions-impl/src/main/java/com/duckduckgo/subscriptions/impl/store/PaywallMetricsDataStore.kt
Other components
- Browser user
- VPN controller
Connections 8
- Browser user → WebView sessions: uses browser
- Recent app controls → App protection state: observes state
app-tracking-protection/vpn-impl/src/main/java/com/duckduckgo/mobile/android/vpn/apps/ui/ManageRecentAppsProtectionActivity.kt - Duck.ai JS bridge → Duck.ai bridge storage: reads settings
duckchat/duckchat-store/src/main/java/com/duckduckgo/duckchat/store/impl/handler/DuckAiNativeStorageJsMessageHandler.kt - PIR scan service → PIR job runner: runs jobs
pir/pir-impl/src/main/java/com/duckduckgo/pir/impl/scan/PirForegroundScanService.kt - VPN controller API → VPN controller: calls API
network-protection/network-protection-impl/src/main/java/com/duckduckgo/networkprotection/impl/configuration/WgVpnControllerService.kt - Web local storage → Storage settings parser: parses settings
app/src/main/java/com/duckduckgo/app/browser/weblocalstorage/WebLocalStorageManager.kt - Paywall metrics → Paywall metrics store: records metrics
subscriptions/subscriptions-impl/src/main/java/com/duckduckgo/subscriptions/impl/pixels/PaywallMetricsManager.kt - Persistent storage → Persistent storage API: implements API
persistent-storage/persistent-storage-impl/src/main/java/com/duckduckgo/persistentstorage/impl/RealPersistentStorage.kt