# mozilla/enterprise-firefox architecture

> Architecture diagram of the GitHub repository mozilla/enterprise-firefox, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mozilla/enterprise-firefox
- Repository: https://github.com/mozilla/enterprise-firefox

## Overview

Firefox is a desktop web browser. A typical user searches or enters a destination and receives a rendered web page, but the supplied excerpts do not show that end-to-end navigation path, so this map focuses on evidenced browser and web-platform subsystems rather than inventing a route. The sampled code covers search-engine state, browser storage, and media; the tree also shows broad accessibility and platform integrations, but their internal relationships were not sampled.

Main entry points: [`dom/storage/SessionStorageManager.cpp`](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/SessionStorageManager.cpp) (Session storage manager), [`dom/media/webrtc/MediaEngineWebRTCAudio.cpp`](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/webrtc/MediaEngineWebRTCAudio.cpp) (WebRTC audio capture), [`browser/components/urlbar/content/SearchEngineStore.mjs`](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/browser/components/urlbar/content/SearchEngineStore.mjs) (Search engine store), [`dom/quota/StorageManager.cpp`](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/quota/StorageManager.cpp) (Quota API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser_ui["Browser UI"]
  node_search_store["Search engine store"]
  node_urlbar_shared["URL bar shared<br/>[UrlbarShared.mjs]"]
end

subgraph group_storage["Web Storage"]
  node_legacy_local["Local storage manager"]
  node_next_local["Next-gen local manager"]
  node_session_storage["Session storage manager"]
  node_storage_observer["Session observer"]
  node_storage_ipc["Storage IPC<br/>[StorageIPC.h]"]
  node_quota_manager["Quota API<br/>[StorageManager.cpp]"]
  node_filesystem_handler["File-system requests"]
end

subgraph group_media["Media Runtime"]
  node_playback_machine["External playback"]
  node_media_decoder["Media decoder module"]
  node_webrtc_audio["WebRTC audio capture"]
  node_media_manager["Media manager<br/>[MediaManager.h]"]
  node_track_graph["Media track graph<br/>[MediaTrackGraph.h]"]
end

node_user(("Browser user"))

node_search_store -->|"uses logging"| node_urlbar_shared
node_session_storage -->|"registers observer"| node_storage_observer
node_session_storage -.->|"uses IPC"| node_storage_ipc
node_quota_manager -.->|"requests file system"| node_filesystem_handler
node_playback_machine -->|"checks support"| node_media_decoder
node_webrtc_audio -.->|"uses media services"| node_media_manager
node_webrtc_audio -.->|"processes audio tracks"| node_track_graph

click node_search_store "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/browser/components/urlbar/content/SearchEngineStore.mjs"
click node_urlbar_shared "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/browser/components/urlbar/content/UrlbarShared.mjs"
click node_legacy_local "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/LocalStorageManager.cpp"
click node_next_local "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/localstorage/LocalStorageManager2.cpp"
click node_session_storage "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/SessionStorageManager.cpp"
click node_storage_observer "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/SessionStorageObserver.h"
click node_storage_ipc "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/StorageIPC.h"
click node_quota_manager "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/quota/StorageManager.cpp"
click node_filesystem_handler "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/fs/include/fs/FileSystemRequestHandler.h"
click node_playback_machine "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/ExternalEngineStateMachine.cpp"
click node_media_decoder "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/platforms/wmf/MFMediaEngineDecoderModule.h"
click node_webrtc_audio "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/webrtc/MediaEngineWebRTCAudio.cpp"
click node_media_manager "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/MediaManager.h"
click node_track_graph "https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/MediaTrackGraph.h"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_search_store,node_urlbar_shared,node_user toneBlue
class node_legacy_local,node_next_local,node_session_storage,node_storage_observer,node_storage_ipc,node_quota_manager,node_filesystem_handler toneAmber
class node_playback_machine,node_media_decoder,node_webrtc_audio,node_media_manager,node_track_graph toneMint
```

## Components

### Browser UI

- [Search engine store](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/browser/components/urlbar/content/SearchEngineStore.mjs): `browser/components/urlbar/content/SearchEngineStore.mjs`
- [URL bar shared](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/browser/components/urlbar/content/UrlbarShared.mjs): `browser/components/urlbar/content/UrlbarShared.mjs`

### Web Storage

- [Local storage manager](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/LocalStorageManager.cpp): `dom/storage/LocalStorageManager.cpp`
- [Next-gen local manager](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/localstorage/LocalStorageManager2.cpp): `dom/localstorage/LocalStorageManager2.cpp`
- [Session storage manager](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/SessionStorageManager.cpp): `dom/storage/SessionStorageManager.cpp`
- [Session observer](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/SessionStorageObserver.h): `dom/storage/SessionStorageObserver.h`
- [Storage IPC](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/storage/StorageIPC.h): `dom/storage/StorageIPC.h`
- [Quota API](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/quota/StorageManager.cpp): `dom/quota/StorageManager.cpp`
- [File-system requests](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/fs/include/fs/FileSystemRequestHandler.h): `dom/fs/include/fs/FileSystemRequestHandler.h`

### Media Runtime

- [External playback](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/ExternalEngineStateMachine.cpp): `dom/media/ExternalEngineStateMachine.cpp`
- [Media decoder module](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/platforms/wmf/MFMediaEngineDecoderModule.h): `dom/media/platforms/wmf/MFMediaEngineDecoderModule.h`
- [WebRTC audio capture](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/webrtc/MediaEngineWebRTCAudio.cpp): `dom/media/webrtc/MediaEngineWebRTCAudio.cpp`
- [Media manager](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/MediaManager.h): `dom/media/MediaManager.h`
- [Media track graph](https://github.com/mozilla/enterprise-firefox/blob/enterprise-main/dom/media/MediaTrackGraph.h): `dom/media/MediaTrackGraph.h`

### Other components

- **Browser user**

## Connections

- Search engine store → URL bar shared: uses logging (evidence: `browser/components/urlbar/content/SearchEngineStore.mjs`)
- Session storage manager → Session observer: registers observer (evidence: `dom/storage/SessionStorageManager.cpp`)
- Session storage manager → Storage IPC: uses IPC (evidence: `dom/storage/SessionStorageManager.cpp`)
- Quota API → File-system requests: requests file system (evidence: `dom/quota/StorageManager.cpp`)
- External playback → Media decoder module: checks support (evidence: `dom/media/ExternalEngineStateMachine.cpp`)
- WebRTC audio capture → Media manager: uses media services (evidence: `dom/media/webrtc/MediaEngineWebRTCAudio.cpp`)
- WebRTC audio capture → Media track graph: processes audio tracks (evidence: `dom/media/webrtc/MediaEngineWebRTCAudio.cpp`)
