# adonais/iceweasel architecture

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

- Interactive diagram: https://gitdiagram.com/adonais/iceweasel
- Repository: https://github.com/adonais/iceweasel

## Overview

Iceweasel is a Firefox-derived web browser. Its principal user workflow is interacting with browser chrome to navigate or search, then using web-platform services while viewing pages; the tree also shows accessibility adapters for platform assistive technology. The excerpts directly support only a few internal relationships, such as search-engine store logging and storage/media dependencies. Browser-chrome-to-search and several broader product links are shown as unverified, not as inspected call paths.

Main entry points: [`browser/base/content/browser.js`](https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/base/content/browser.js) (Browser interface), [`browser/components/urlbar/content/UrlbarShared.mjs`](https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/components/urlbar/content/UrlbarShared.mjs) (URL bar), [`accessible/base`](https://github.com/adonais/iceweasel/tree/iceweasel_release/accessible/base) (Accessibility core), [`browser/components/urlbar/content/SearchEngineStore.mjs`](https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/components/urlbar/content/SearchEngineStore.mjs) (Search engines)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser chrome"]
  node_chrome["Browser interface<br/>[browser.js]"]
  node_actors["Browser actors"]
  node_urlbar["URL bar<br/>[UrlbarShared.mjs]"]
  node_engines["Search engines"]
end

subgraph group_web["Web platform"]
  node_window["Window context"]
  node_contentutils["Content utilities<br/>[nsContentUtils.h]"]
  node_storageapi["Storage API<br/>[StorageManager.cpp]"]
  node_filesystem["File system requests"]
  node_cache["Cache storage<br/>[CacheStorage.cpp]"]
  node_localstorage["Local storage"]
  node_sessionstorage["Session storage"]
  node_storageipc["Storage IPC<br/>[StorageIPC.h]"]
end

subgraph group_media["Media"]
  node_webrtc["WebRTC audio"]
  node_mediagraph["Media track graph<br/>[MediaTrackGraph.h]"]
  node_externalmedia["External playback"]
end

subgraph group_accessibility["Accessibility"]
  node_accessiblecore["Accessibility core"]
  node_platformaccess["Platform adapters"]
  node_atkadapters["ATK adapters"]
end

node_user(("Browser user"))

node_user -.->|"uses"| node_chrome
node_chrome -.->|"offers navigation"| node_urlbar
node_urlbar -.->|"uses engine store"| node_engines
node_engines -->|"imports shared utilities"| node_urlbar
node_chrome -.->|"coordinates page features"| node_actors
node_window -.->|"exposes storage"| node_storageapi
node_storageapi -->|"references request handler"| node_filesystem
node_cache -->|"uses utilities"| node_contentutils
node_localstorage -->|"uses IPC"| node_storageipc
node_sessionstorage -->|"uses IPC"| node_storageipc
node_webrtc -->|"uses track graph"| node_mediagraph
node_externalmedia -.->|"uses media graph"| node_mediagraph
node_accessiblecore -.->|"adapts for Windows"| node_platformaccess
node_accessiblecore -.->|"adapts for ATK"| node_atkadapters

click node_chrome "https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/base/content/browser.js"
click node_actors "https://github.com/adonais/iceweasel/tree/iceweasel_release/browser/actors"
click node_urlbar "https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/components/urlbar/content/UrlbarShared.mjs"
click node_engines "https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/components/urlbar/content/SearchEngineStore.mjs"
click node_window "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/base/nsGlobalWindowInner.h"
click node_contentutils "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/base/nsContentUtils.h"
click node_storageapi "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/quota/StorageManager.cpp"
click node_filesystem "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/fs/include/fs/FileSystemRequestHandler.h"
click node_cache "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/cache/CacheStorage.cpp"
click node_localstorage "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/storage/LocalStorageManager.cpp"
click node_sessionstorage "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/storage/SessionStorageManager.cpp"
click node_storageipc "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/storage/StorageIPC.h"
click node_webrtc "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/media/webrtc/MediaEngineWebRTCAudio.cpp"
click node_mediagraph "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/media/MediaTrackGraph.h"
click node_externalmedia "https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/media/ExternalEngineStateMachine.cpp"
click node_accessiblecore "https://github.com/adonais/iceweasel/tree/iceweasel_release/accessible/base"
click node_platformaccess "https://github.com/adonais/iceweasel/tree/iceweasel_release/accessible/windows/msaa"
click node_atkadapters "https://github.com/adonais/iceweasel/tree/iceweasel_release/accessible/atk"

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_chrome,node_actors,node_urlbar,node_engines,node_user toneBlue
class node_window,node_contentutils,node_storageapi,node_filesystem,node_cache,node_localstorage,node_sessionstorage,node_storageipc toneAmber
class node_webrtc,node_mediagraph,node_externalmedia toneMint
class node_accessiblecore,node_platformaccess,node_atkadapters toneRose
```

## Components

### Browser chrome

- [Browser interface](https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/base/content/browser.js): `browser/base/content/browser.js`
- [Browser actors](https://github.com/adonais/iceweasel/tree/iceweasel_release/browser/actors): `browser/actors`
- [URL bar](https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/components/urlbar/content/UrlbarShared.mjs): `browser/components/urlbar/content/UrlbarShared.mjs`
- [Search engines](https://github.com/adonais/iceweasel/blob/iceweasel_release/browser/components/urlbar/content/SearchEngineStore.mjs): `browser/components/urlbar/content/SearchEngineStore.mjs`

### Web platform

- [Window context](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/base/nsGlobalWindowInner.h): `dom/base/nsGlobalWindowInner.h`
- [Content utilities](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/base/nsContentUtils.h): `dom/base/nsContentUtils.h`
- [Storage API](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/quota/StorageManager.cpp): `dom/quota/StorageManager.cpp`
- [File system requests](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/fs/include/fs/FileSystemRequestHandler.h): `dom/fs/include/fs/FileSystemRequestHandler.h`
- [Cache storage](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/cache/CacheStorage.cpp): `dom/cache/CacheStorage.cpp`
- [Local storage](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/storage/LocalStorageManager.cpp): `dom/storage/LocalStorageManager.cpp`
- [Session storage](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/storage/SessionStorageManager.cpp): `dom/storage/SessionStorageManager.cpp`
- [Storage IPC](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/storage/StorageIPC.h): `dom/storage/StorageIPC.h`

### Media

- [WebRTC audio](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/media/webrtc/MediaEngineWebRTCAudio.cpp): `dom/media/webrtc/MediaEngineWebRTCAudio.cpp`
- [Media track graph](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/media/MediaTrackGraph.h): `dom/media/MediaTrackGraph.h`
- [External playback](https://github.com/adonais/iceweasel/blob/iceweasel_release/dom/media/ExternalEngineStateMachine.cpp): `dom/media/ExternalEngineStateMachine.cpp`

### Accessibility

- [Accessibility core](https://github.com/adonais/iceweasel/tree/iceweasel_release/accessible/base): `accessible/base`
- [Platform adapters](https://github.com/adonais/iceweasel/tree/iceweasel_release/accessible/windows/msaa): `accessible/windows/msaa`
- [ATK adapters](https://github.com/adonais/iceweasel/tree/iceweasel_release/accessible/atk): `accessible/atk`

### Other components

- **Browser user**

## Connections

- Browser user → Browser interface: uses
- Browser interface → URL bar: offers navigation
- URL bar → Search engines: uses engine store (evidence: `browser/components/urlbar/content/SearchEngineStore.mjs`)
- Search engines → URL bar: imports shared utilities (evidence: `browser/components/urlbar/content/SearchEngineStore.mjs`)
- Browser interface → Browser actors: coordinates page features
- Window context → Storage API: exposes storage
- Storage API → File system requests: references request handler (evidence: `dom/quota/StorageManager.cpp`)
- Cache storage → Content utilities: uses utilities (evidence: `dom/cache/CacheStorage.cpp`)
- Local storage → Storage IPC: uses IPC (evidence: `dom/storage/LocalStorageManager.cpp`)
- Session storage → Storage IPC: uses IPC (evidence: `dom/storage/SessionStorageManager.cpp`)
- WebRTC audio → Media track graph: uses track graph (evidence: `dom/media/webrtc/MediaEngineWebRTCAudio.cpp`)
- External playback → Media track graph: uses media graph
- Accessibility core → Platform adapters: adapts for Windows
- Accessibility core → ATK adapters: adapts for ATK
