# mozilla-firefox/firefox architecture

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

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

## Overview

Firefox is a desktop and mobile web browser. Its broad runtime spans browser chrome, web-platform services, accessibility, storage, and media; the README identifies the product but does not document internal call flows. The graph therefore shows evidenced relationships from sampled source and marks plausible user entry and unsampled subsystem links as unverified, rather than treating them as established calls.

Main entry points: [`dom/base/nsGlobalWindowInner.h`](https://github.com/mozilla-firefox/firefox/blob/main/dom/base/nsGlobalWindowInner.h) (Window runtime), [`dom/quota/StorageManager.cpp`](https://github.com/mozilla-firefox/firefox/blob/main/dom/quota/StorageManager.cpp) (Storage API), [`dom/storage/LocalStorageManager.cpp`](https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/LocalStorageManager.cpp) (Local storage), [`dom/storage/SessionStorageManager.cpp`](https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/SessionStorageManager.cpp) (Session storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser experience"]
  node_browser_entry["Browser interface<br/>[browser.js]"]
  node_search_engines["Search engines"]
  node_urlbar_shared["URL bar utilities<br/>[UrlbarShared.mjs]"]
  node_browser_actors["Browser actors"]
end

subgraph group_a11y["Accessibility"]
  node_accessibility_core["Accessibility core"]
  node_accessible_tree["Document accessibles<br/>[DocAccessible.cpp]"]
  node_accessibility_platforms["Platform adapters<br/>[AccessibleWrap.cpp]"]
end

subgraph group_platform["Web platform"]
  node_dom_window["Window runtime"]
  node_window_interface["Window interface<br/>[nsPIDOMWindow.h]"]
  node_content_utilities["DOM utilities<br/>[nsContentUtils.h]"]
end

subgraph group_storage["Web storage"]
  node_quota_manager["Storage API<br/>[StorageManager.cpp]"]
  node_legacy_local_storage[("Local storage")]
  node_nextgen_local_storage["Local storage manager"]
  node_session_storage[("Session storage")]
  node_storage_ipc["Storage IPC<br/>[StorageIPC.h]"]
  node_storage_db["Storage database thread<br/>[StorageDBThread.h]"]
  node_performance_storage["Performance storage"]
end

subgraph group_media["Media"]
  node_microphone["WebRTC microphone"]
  node_media_engine["External playback"]
end

node_user(("Browser user"))

node_user -.->|"uses"| node_browser_entry
node_search_engines -->|"uses utilities"| node_urlbar_shared
node_legacy_local_storage -->|"references"| node_storage_db
node_legacy_local_storage -->|"references"| node_storage_ipc
node_session_storage -->|"references"| node_storage_ipc
node_quota_manager -->|"uses window API"| node_dom_window
node_nextgen_local_storage -->|"uses window API"| node_window_interface
node_performance_storage -->|"references window"| node_dom_window
node_microphone -->|"references window"| node_dom_window
node_content_utilities -->|"references"| node_window_interface
node_quota_manager -->|"uses utilities"| node_content_utilities
node_session_storage -.->|"may use"| node_storage_db
node_browser_entry -.->|"dispatches to"| node_browser_actors
node_accessibility_core -.->|"manages"| node_accessible_tree
node_accessible_tree -.->|"exposes through"| node_accessibility_platforms

click node_browser_entry "https://github.com/mozilla-firefox/firefox/blob/main/browser/base/content/browser.js"
click node_search_engines "https://github.com/mozilla-firefox/firefox/blob/main/browser/components/urlbar/content/SearchEngineStore.mjs"
click node_urlbar_shared "https://github.com/mozilla-firefox/firefox/blob/main/browser/components/urlbar/content/UrlbarShared.mjs"
click node_browser_actors "https://github.com/mozilla-firefox/firefox/blob/main/browser/actors/BrowserTabChild.sys.mjs"
click node_accessibility_core "https://github.com/mozilla-firefox/firefox/blob/main/accessible/base/nsAccessibilityService.cpp"
click node_accessible_tree "https://github.com/mozilla-firefox/firefox/blob/main/accessible/generic/DocAccessible.cpp"
click node_accessibility_platforms "https://github.com/mozilla-firefox/firefox/blob/main/accessible/windows/msaa/AccessibleWrap.cpp"
click node_dom_window "https://github.com/mozilla-firefox/firefox/blob/main/dom/base/nsGlobalWindowInner.h"
click node_window_interface "https://github.com/mozilla-firefox/firefox/blob/main/dom/base/nsPIDOMWindow.h"
click node_content_utilities "https://github.com/mozilla-firefox/firefox/blob/main/dom/base/nsContentUtils.h"
click node_quota_manager "https://github.com/mozilla-firefox/firefox/blob/main/dom/quota/StorageManager.cpp"
click node_legacy_local_storage "https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/LocalStorageManager.cpp"
click node_nextgen_local_storage "https://github.com/mozilla-firefox/firefox/blob/main/dom/localstorage/LocalStorageManager2.cpp"
click node_session_storage "https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/SessionStorageManager.cpp"
click node_storage_ipc "https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/StorageIPC.h"
click node_storage_db "https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/StorageDBThread.h"
click node_performance_storage "https://github.com/mozilla-firefox/firefox/blob/main/dom/performance/PerformanceStorageWorker.cpp"
click node_microphone "https://github.com/mozilla-firefox/firefox/blob/main/dom/media/webrtc/MediaEngineWebRTCAudio.cpp"
click node_media_engine "https://github.com/mozilla-firefox/firefox/blob/main/dom/media/ExternalEngineStateMachine.cpp"

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_browser_entry,node_search_engines,node_urlbar_shared,node_browser_actors,node_user toneBlue
class node_accessibility_core,node_accessible_tree,node_accessibility_platforms toneAmber
class node_dom_window,node_window_interface,node_content_utilities toneMint
class node_quota_manager,node_legacy_local_storage,node_nextgen_local_storage,node_session_storage,node_storage_ipc,node_storage_db,node_performance_storage toneRose
class node_microphone,node_media_engine toneIndigo
```

## Components

### Browser experience

- [Browser interface](https://github.com/mozilla-firefox/firefox/blob/main/browser/base/content/browser.js): `browser/base/content/browser.js`
- [Search engines](https://github.com/mozilla-firefox/firefox/blob/main/browser/components/urlbar/content/SearchEngineStore.mjs): `browser/components/urlbar/content/SearchEngineStore.mjs`
- [URL bar utilities](https://github.com/mozilla-firefox/firefox/blob/main/browser/components/urlbar/content/UrlbarShared.mjs): `browser/components/urlbar/content/UrlbarShared.mjs`
- [Browser actors](https://github.com/mozilla-firefox/firefox/blob/main/browser/actors/BrowserTabChild.sys.mjs): `browser/actors/BrowserTabChild.sys.mjs`

### Accessibility

- [Accessibility core](https://github.com/mozilla-firefox/firefox/blob/main/accessible/base/nsAccessibilityService.cpp): `accessible/base/nsAccessibilityService.cpp`
- [Document accessibles](https://github.com/mozilla-firefox/firefox/blob/main/accessible/generic/DocAccessible.cpp): `accessible/generic/DocAccessible.cpp`
- [Platform adapters](https://github.com/mozilla-firefox/firefox/blob/main/accessible/windows/msaa/AccessibleWrap.cpp): `accessible/windows/msaa/AccessibleWrap.cpp`

### Web platform

- [Window runtime](https://github.com/mozilla-firefox/firefox/blob/main/dom/base/nsGlobalWindowInner.h): `dom/base/nsGlobalWindowInner.h`
- [Window interface](https://github.com/mozilla-firefox/firefox/blob/main/dom/base/nsPIDOMWindow.h): `dom/base/nsPIDOMWindow.h`
- [DOM utilities](https://github.com/mozilla-firefox/firefox/blob/main/dom/base/nsContentUtils.h): `dom/base/nsContentUtils.h`

### Web storage

- [Storage API](https://github.com/mozilla-firefox/firefox/blob/main/dom/quota/StorageManager.cpp): `dom/quota/StorageManager.cpp`
- [Local storage](https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/LocalStorageManager.cpp): `dom/storage/LocalStorageManager.cpp`
- [Local storage manager](https://github.com/mozilla-firefox/firefox/blob/main/dom/localstorage/LocalStorageManager2.cpp): `dom/localstorage/LocalStorageManager2.cpp`
- [Session storage](https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/SessionStorageManager.cpp): `dom/storage/SessionStorageManager.cpp`
- [Storage IPC](https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/StorageIPC.h): `dom/storage/StorageIPC.h`
- [Storage database thread](https://github.com/mozilla-firefox/firefox/blob/main/dom/storage/StorageDBThread.h): `dom/storage/StorageDBThread.h`
- [Performance storage](https://github.com/mozilla-firefox/firefox/blob/main/dom/performance/PerformanceStorageWorker.cpp): `dom/performance/PerformanceStorageWorker.cpp`

### Media

- [WebRTC microphone](https://github.com/mozilla-firefox/firefox/blob/main/dom/media/webrtc/MediaEngineWebRTCAudio.cpp): `dom/media/webrtc/MediaEngineWebRTCAudio.cpp`
- [External playback](https://github.com/mozilla-firefox/firefox/blob/main/dom/media/ExternalEngineStateMachine.cpp): `dom/media/ExternalEngineStateMachine.cpp`

### Other components

- **Browser user**

## Connections

- Browser user → Browser interface: uses
- Search engines → URL bar utilities: uses utilities (evidence: `browser/components/urlbar/content/SearchEngineStore.mjs`)
- Local storage → Storage database thread: references (evidence: `dom/storage/LocalStorageManager.cpp`)
- Local storage → Storage IPC: references (evidence: `dom/storage/LocalStorageManager.cpp`)
- Session storage → Storage IPC: references (evidence: `dom/storage/SessionStorageManager.cpp`)
- Storage API → Window runtime: uses window API (evidence: `dom/quota/StorageManager.cpp`)
- Local storage manager → Window interface: uses window API (evidence: `dom/localstorage/LocalStorageManager2.cpp`)
- Performance storage → Window runtime: references window (evidence: `dom/performance/PerformanceStorageWorker.cpp`)
- WebRTC microphone → Window runtime: references window (evidence: `dom/media/webrtc/MediaEngineWebRTCAudio.cpp`)
- DOM utilities → Window interface: references (evidence: `dom/base/nsContentUtils.h`)
- Storage API → DOM utilities: uses utilities (evidence: `dom/quota/StorageManager.cpp`)
- Session storage → Storage database thread: may use
- Browser interface → Browser actors: dispatches to
- Accessibility core → Document accessibles: manages
- Document accessibles → Platform adapters: exposes through
