# mozilla/firefox architecture

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

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

## Overview

Firefox is a desktop and mobile web browser. Its principal workflow is a user entering a search or address, Firefox coordinating browser UI and page activity, and the browser presenting web content; the README establishes the product, while the sampled files do not expose that full navigation/rendering path. The graph therefore shows documented product scope and sampled runtime branches for search, storage, and media. Unsampled domain links are marked dashed with no evidence path; source-index references support the explicit internal links shown.

Main entry points: [`dom/base`](https://github.com/mozilla/firefox/tree/main/dom/base) (DOM and window APIs), [`browser/base/content/browser.js`](https://github.com/mozilla/firefox/blob/main/browser/base/content/browser.js) (Browser interface), [`dom/quota/StorageManager.cpp`](https://github.com/mozilla/firefox/blob/main/dom/quota/StorageManager.cpp) (Storage API), [`browser/components/urlbar/content/UrlbarShared.mjs`](https://github.com/mozilla/firefox/blob/main/browser/components/urlbar/content/UrlbarShared.mjs) (Address and search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser experience"]
  node_firefox["Firefox application<br/>[nsBrowserApp.cpp]"]
  node_browser_ui["Browser interface<br/>[browser.js]"]
  node_urlbar["Address and search<br/>[UrlbarShared.mjs]"]
  node_search_store["Search engine store"]
  node_engine_add["Add search engine<br/>[addEngine.js]"]
end

subgraph group_platform["Web platform"]
  node_dom_core["DOM and window APIs"]
  node_accessibility["Accessibility tree"]
  node_blob_storage["Blob construction"]
end

subgraph group_storage["Web storage"]
  node_storage_api["Storage API<br/>[StorageManager.cpp]"]
  node_quota["Quota management<br/>[StorageManager.cpp]"]
  node_local_storage["Local storage"]
  node_local_storage_next["Local storage requests"]
  node_session_storage["Session storage"]
  node_storage_ipc["Storage IPC<br/>[StorageIPC.h]"]
  node_storage_db["Storage database thread<br/>[StorageDBThread.h]"]
end

subgraph group_media["Media"]
  node_media_capture["WebRTC audio capture"]
  node_media_playback["External media playback"]
end

node_user(("Browser user"))

node_user -->|"launches"| node_firefox
node_firefox -.->|"presents"| node_browser_ui
node_user -.->|"searches"| node_urlbar
node_urlbar -->|"loads engines"| node_search_store
node_search_store -->|"requests icons"| node_urlbar
node_browser_ui -.->|"offers engine setup"| node_engine_add
node_browser_ui -.->|"hosts web content"| node_dom_core
node_dom_core -.->|"exposes accessible content"| node_accessibility
node_dom_core -.->|"exposes storage"| node_storage_api
node_storage_api -->|"requests estimates"| node_quota
node_storage_api -->|"uses global object"| node_dom_core
node_local_storage -->|"uses database thread"| node_storage_db
node_local_storage -->|"uses IPC"| node_storage_ipc
node_local_storage_next -->|"constructs request actors"| node_storage_ipc
node_session_storage -->|"uses IPC"| node_storage_ipc
node_session_storage -.->|"uses database thread"| node_storage_db
node_dom_core -->|"provides window context"| node_media_capture
node_dom_core -.->|"supports playback"| node_media_playback
node_blob_storage -.->|"creates web blobs"| node_dom_core

click node_firefox "https://github.com/mozilla/firefox/blob/main/browser/app/nsBrowserApp.cpp"
click node_browser_ui "https://github.com/mozilla/firefox/blob/main/browser/base/content/browser.js"
click node_urlbar "https://github.com/mozilla/firefox/blob/main/browser/components/urlbar/content/UrlbarShared.mjs"
click node_search_store "https://github.com/mozilla/firefox/blob/main/browser/components/urlbar/content/SearchEngineStore.mjs"
click node_engine_add "https://github.com/mozilla/firefox/blob/main/browser/components/search/content/addEngine.js"
click node_dom_core "https://github.com/mozilla/firefox/tree/main/dom/base"
click node_accessibility "https://github.com/mozilla/firefox/tree/main/accessible/base"
click node_storage_api "https://github.com/mozilla/firefox/blob/main/dom/quota/StorageManager.cpp"
click node_quota "https://github.com/mozilla/firefox/blob/main/dom/quota/StorageManager.cpp"
click node_local_storage "https://github.com/mozilla/firefox/blob/main/dom/storage/LocalStorageManager.cpp"
click node_local_storage_next "https://github.com/mozilla/firefox/blob/main/dom/localstorage/LocalStorageManager2.cpp"
click node_session_storage "https://github.com/mozilla/firefox/blob/main/dom/storage/SessionStorageManager.cpp"
click node_storage_ipc "https://github.com/mozilla/firefox/blob/main/dom/storage/StorageIPC.h"
click node_storage_db "https://github.com/mozilla/firefox/blob/main/dom/storage/StorageDBThread.h"
click node_media_capture "https://github.com/mozilla/firefox/blob/main/dom/media/webrtc/MediaEngineWebRTCAudio.cpp"
click node_media_playback "https://github.com/mozilla/firefox/blob/main/dom/media/ExternalEngineStateMachine.cpp"
click node_blob_storage "https://github.com/mozilla/firefox/blob/main/dom/file/MutableBlobStorage.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_firefox,node_browser_ui,node_urlbar,node_search_store,node_engine_add,node_user toneBlue
class node_dom_core,node_accessibility,node_blob_storage toneAmber
class node_storage_api,node_quota,node_local_storage,node_local_storage_next,node_session_storage,node_storage_ipc,node_storage_db toneMint
class node_media_capture,node_media_playback toneRose
```

## Components

### Browser experience

- [Firefox application](https://github.com/mozilla/firefox/blob/main/browser/app/nsBrowserApp.cpp): `browser/app/nsBrowserApp.cpp`
- [Browser interface](https://github.com/mozilla/firefox/blob/main/browser/base/content/browser.js): `browser/base/content/browser.js`
- [Address and search](https://github.com/mozilla/firefox/blob/main/browser/components/urlbar/content/UrlbarShared.mjs): `browser/components/urlbar/content/UrlbarShared.mjs`
- [Search engine store](https://github.com/mozilla/firefox/blob/main/browser/components/urlbar/content/SearchEngineStore.mjs): `browser/components/urlbar/content/SearchEngineStore.mjs`
- [Add search engine](https://github.com/mozilla/firefox/blob/main/browser/components/search/content/addEngine.js): `browser/components/search/content/addEngine.js`

### Web platform

- [DOM and window APIs](https://github.com/mozilla/firefox/tree/main/dom/base): `dom/base`
- [Accessibility tree](https://github.com/mozilla/firefox/tree/main/accessible/base): `accessible/base`
- [Blob construction](https://github.com/mozilla/firefox/blob/main/dom/file/MutableBlobStorage.cpp): `dom/file/MutableBlobStorage.cpp`

### Web storage

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

### Media

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

### Other components

- **Browser user**

## Connections

- Browser user → Firefox application: launches
- Firefox application → Browser interface: presents
- Browser user → Address and search: searches
- Address and search → Search engine store: loads engines (evidence: `browser/components/urlbar/content/SearchEngineStore.mjs`)
- Search engine store → Address and search: requests icons (evidence: `browser/components/urlbar/content/SearchEngineStore.mjs`)
- Browser interface → Add search engine: offers engine setup
- Browser interface → DOM and window APIs: hosts web content
- DOM and window APIs → Accessibility tree: exposes accessible content
- DOM and window APIs → Storage API: exposes storage (evidence: `dom/quota/StorageManager.cpp`)
- Storage API → Quota management: requests estimates (evidence: `dom/quota/StorageManager.cpp`)
- Storage API → DOM and window APIs: uses global object (evidence: `dom/quota/StorageManager.cpp`)
- Local storage → Storage database thread: uses database thread (evidence: `dom/storage/LocalStorageManager.cpp`)
- Local storage → Storage IPC: uses IPC (evidence: `dom/storage/LocalStorageManager.cpp`)
- Local storage requests → Storage IPC: constructs request actors (evidence: `dom/localstorage/LocalStorageManager2.cpp`)
- Session storage → Storage IPC: uses IPC (evidence: `dom/storage/SessionStorageManager.cpp`)
- Session storage → Storage database thread: uses database thread
- DOM and window APIs → WebRTC audio capture: provides window context (evidence: `dom/media/webrtc/MediaEngineWebRTCAudio.cpp`)
- DOM and window APIs → External media playback: supports playback
- Blob construction → DOM and window APIs: creates web blobs
