How ironfox-oss/ironfox works
IronFox is a privacy- and security-oriented Android web browser fork. A representative settings workflow is user changes a browser option, the app persists it and applies the corresponding Gecko preference, then reloads the session. The tree also shows onboarding, Gecko-side preference utilities, add-on support, wallpaper handling, distribution/experimentation, and telemetry. The supplied excerpts confirm only selected calls; edges for major but unsampled browser subsystems are omitted rather than inferred.
Main entry points: IronFoxSettingsFragment.kt Settings screen · IronFoxPreferences.kt App preferences · IronFoxPreferencesPage.kt Preference onboarding · GeckoSettingsBridge.kt Gecko settings bridge
Components 32
Browser settings
- Settings screen
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/settings/IronFoxSettingsFragment.kt - App preferences
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/IronFoxPreferences.kt - Settings visibility
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/FenixSettingsVisibilityManager.kt - Fenix settings
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/IronFoxSettings.kt - Preference helpers
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/IFPrefUtils.kt - Preference definitions
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/IFPrefs.kt
Gecko integration
- Gecko settings bridge
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/GeckoSettingsBridge.kt - Gecko settings bridge
patches/gecko-overlay/ironfox/utils/GeckoSettingsBridge.sys.mjs - Add-on utilities
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/IFAddonUtils.kt - Gecko add-on utilities
patches/gecko-overlay/ironfox/utils/IFAddonUtils.sys.mjs - Gecko preference utilities
patches/gecko-overlay/ironfox/utils/IFPrefUtils.sys.mjs - Gecko defaults
patches/gecko-overlay/ironfox/prefs/ironfox.js - DoH providers
patches/gecko-overlay/ironfox/android/core/src/main/java/org/ironfoxoss/core/IFDohProviders.kt - Browser constants
patches/gecko-overlay/ironfox/android/core/src/main/java/org/ironfoxoss/core/IFConstants.kt
Onboarding and UI
- Preference onboarding
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/onboarding/view/IronFoxPreferencesPage.kt - DoH onboarding
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/onboarding/view/IronFoxPreferenceDohOnboardingPage.kt - Terms onboarding
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/onboarding/view/TermsOfServiceOnboardingPage.kt - About pages
patches/gecko-overlay/ironfox/about/IronFoxAboutPages.sys.mjs - Wallpaper downloads
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/wallpapers/WallpaperDownloader.kt - Distribution setup
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/distributions/DistributionIdManager.kt - Experiment setup
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/experiments/NimbusSetup.kt
Telemetry and operations
- Analytics
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/components/Analytics.kt - Metrics helper
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/components/MetricsServiceHelper.kt - Glean runtime
patches/glean-overlay/glean-core/android/src/main/java/mozilla/telemetry/glean/Glean.kt - Telemetry dispatch
patches/glean-overlay/glean-core/android/src/main/java/mozilla/telemetry/glean/Dispatchers.kt - Ping scheduler
patches/glean-overlay/glean-core/android/src/main/java/mozilla/telemetry/glean/scheduler/MetricsPingScheduler.kt - Ping upload worker
patches/glean-overlay/glean-core/android/src/main/java/mozilla/telemetry/glean/scheduler/PingUploadWorker.kt - Ping uploader
patches/glean-overlay/glean-core/android/src/main/java/mozilla/telemetry/glean/net/PingUploader.kt - HTTP uploader
patches/glean-overlay/glean-core/android/src/main/java/mozilla/telemetry/glean/net/HttpURLConnectionUploader.kt - Telemetry service
patches/a-s-overlay/components/sync_manager/android/src/main/java/mozilla/appservices/syncmanager/SyncTelemetry.kt
Other components
- Browser user
- Gecko browser engine
Connections 10
- Browser user → Settings screen: changes options
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/settings/IronFoxSettingsFragment.kt - Settings screen → App preferences: reads and writes
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/settings/IronFoxSettingsFragment.kt - Settings screen → Gecko settings bridge: applies preferences
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/settings/IronFoxSettingsFragment.kt - Settings screen → Gecko browser engine: reloads session
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/settings/IronFoxSettingsFragment.kt - Gecko settings bridge → App preferences: reads settings
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/GeckoSettingsBridge.kt - Settings visibility → App preferences: checks settings
patches/fenix-overlay/app/src/main/java/org/ironfoxoss/ironfox/utils/FenixSettingsVisibilityManager.kt - Preference onboarding → App preferences: sets options
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/onboarding/view/IronFoxPreferencesPage.kt - Preference onboarding → Add-on utilities: uses add-on support
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/onboarding/view/IronFoxPreferencesPage.kt - Metrics helper → Analytics: accepts analytics
patches/fenix-overlay/app/src/main/java/org/mozilla/fenix/components/MetricsServiceHelper.kt - HTTP uploader → Ping uploader: implements uploader
patches/glean-overlay/glean-core/android/src/main/java/mozilla/telemetry/glean/net/HttpURLConnectionUploader.kt