How browserworks/waterfox works
Waterfox is a customizable browser built on Mozilla platform code. Its principal user workflow is browser interaction leading to page and DOM activity, with platform services supporting storage, media, and accessibility. The tree also shows browser startup, content-process actors, security, and browser customization. The graph preserves these as distinct subsystems, but most browser-to-platform call paths were not sampled; those relationships are shown as unverified rather than asserted. The README identifies the product but documents few runtime details.
Main entry points: nsGlobalWindowInner.h Window context · browser.js Browser UI · nsContentUtils.h DOM core · BrowserTabChild.sys.mjs Content actors
Components 18
Browser experience
- Browser UI
browser/base/content/browser.js - Startup glue
browser/components/BrowserGlue.sys.mjs - Browser handler
browser/components/BrowserContentHandler.sys.mjs - UI customization
browser/components/customizableui/DragPositionManager.sys.mjs - Content actors
browser/actors/BrowserTabChild.sys.mjs
Web platform
- Window context
dom/base/nsGlobalWindowInner.h - DOM core
dom/base/nsContentUtils.h - Content security
dom/security/nsContentSecurityManager.cpp
Platform services
- Storage management
dom/quota/StorageManager.cpp - Local storage
dom/storage/LocalStorageManager.cpp - Session storage
dom/storage/SessionStorageManager.cpp - Cache storage
dom/cache/CacheStorage.cpp - Media playback
dom/media/ExternalEngineStateMachine.cpp - WebRTC audio
dom/media/webrtc/MediaEngineWebRTCAudio.cpp
Accessibility
- Accessibility tree
accessible/generic/DocAccessible.cpp - Platform adapters
accessible/windows/msaa/AccessibleWrap.cpp
Other components
- Browser user
- Web content
Connections 17
- Browser user → Browser UI: interacts
- Startup glue → Browser UI: initializes
- Browser UI → Browser handler: handles navigation
- Browser UI → UI customization: configures UI
- Browser UI → Content actors: coordinates content
- Content actors → Web content: communicates
- Web content → Window context: uses context
- Window context → DOM core: exposes DOM
- DOM core → Content security: checks access
- Window context → Local storage: accesses storage
- Window context → Session storage: accesses storage
- Window context → Cache storage: uses cache
- Window context → Storage management: requests estimates
- Web content → Media playback: plays media
- Web content → WebRTC audio: captures audio
- DOM core → Accessibility tree: exposes semantics
- Accessibility tree → Platform adapters: adapts interfaces