# moustachauve/cookie-editor architecture

> Architecture diagram of the GitHub repository moustachauve/cookie-editor, 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/moustachauve/cookie-editor
- Repository: https://github.com/moustachauve/cookie-editor

## Overview

Cookie-Editor is a cross-browser extension for managing cookies on the current tab. Its main workflow is to open a browser UI, check access to the site, load cookies, and let the user edit, create, delete, or export them; popup and DevTools use different cookie-handler paths. Separate branches cover preferences and themes, ads, and Safari’s native extension wrapper. The source excerpts show key calls, while several UI and platform details are supported only by the README or file tree, so those connections are left out where unverified.

Main entry points: [`interface/popup/cookie-list.js`](https://github.com/moustachauve/cookie-editor/blob/master/interface/popup/cookie-list.js) (Popup interface), [`interface/popup/cookieHandlerPopup.js`](https://github.com/moustachauve/cookie-editor/blob/master/interface/popup/cookieHandlerPopup.js) (Popup cookie handler), [`interface/options/options.js`](https://github.com/moustachauve/cookie-editor/blob/master/interface/options/options.js) (Options page), [`interface/lib/optionsHandler.js`](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/optionsHandler.js) (Options handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Extension interfaces"]
  node_popup_ui["Popup interface<br/>[cookie-list.js]"]
  node_options_ui["Options page<br/>[options.js]"]
  node_devtools_ui["DevTools panel<br/>[devtools.js]"]
  node_mobile_ui["Mobile interface<br/>[cookie-list.html]"]
  node_sidepanel_ui["Side panel<br/>[cookie-list.html]"]
end

subgraph group_cookie["Cookie management"]
  node_popup_handler["Popup cookie handler"]
  node_devtools_handler["DevTools cookie handler"]
  node_generic_cookie["Cookie API handler"]
  node_cookie_record["Cookie model<br/>[cookie.js]"]
  node_cookie_store[("Browser cookie store")]
  node_formats["Cookie formats<br/>[jsonFormat.js]"]
  node_header_format["Header and Netscape formats"]
end

subgraph group_settings["Preferences and support"]
  node_options_handler["Options handler<br/>[optionsHandler.js]"]
  node_storage_handler["Extension storage"]
  node_theme_handler["Theme handler<br/>[themeHandler.js]"]
  node_ads["Ad selection<br/>[adHandler.js]"]
end

subgraph group_platform["Browser platforms"]
  node_permissions["Site permissions"]
  node_browser_detect["Browser detection<br/>[browserDetector.js]"]
  node_browser_api["Browser extension APIs"]
  node_safari_bridge["Safari extension bridge"]
end

node_user(("Extension user"))

node_user -->|"opens"| node_popup_ui
node_user -->|"configures"| node_options_ui
node_user -.->|"opens"| node_devtools_ui
node_user -->|"uses"| node_mobile_ui
node_popup_ui -->|"manages cookies"| node_popup_handler
node_popup_ui -->|"renders"| node_cookie_record
node_popup_ui -->|"checks access"| node_permissions
node_popup_ui -->|"loads preferences"| node_options_handler
node_popup_ui -->|"selects ads"| node_ads
node_options_ui -->|"deletes cookies"| node_popup_handler
node_options_ui -->|"updates settings"| node_options_handler
node_options_ui -->|"updates theme"| node_theme_handler
node_options_ui -->|"exports JSON"| node_formats
node_devtools_ui -.->|"manages cookies"| node_devtools_handler
node_popup_handler -->|"extends"| node_generic_cookie
node_devtools_handler -->|"extends"| node_generic_cookie
node_devtools_handler -->|"messages runtime"| node_browser_api
node_generic_cookie -->|"calls cookie API"| node_browser_api
node_browser_api -.->|"reads and writes"| node_cookie_store
node_browser_detect -->|"provides API"| node_browser_api
node_popup_handler -->|"tracks active tab"| node_browser_api
node_permissions -->|"checks site access"| node_browser_api
node_popup_ui -->|"imports formats"| node_header_format
node_options_handler -->|"reads and saves"| node_storage_handler
node_storage_handler -->|"uses local storage"| node_browser_api
node_options_handler -->|"notifies background"| node_browser_api
node_theme_handler -->|"reads theme"| node_options_handler
node_ads -->|"checks dismissals"| node_storage_handler
node_ads -->|"checks browser"| node_browser_detect
node_safari_bridge -.->|"bridges extension"| node_browser_api
node_mobile_ui -.->|"cookie workflow"| node_popup_handler
node_sidepanel_ui -.->|"cookie workflow"| node_popup_handler

click node_popup_ui "https://github.com/moustachauve/cookie-editor/blob/master/interface/popup/cookie-list.js"
click node_options_ui "https://github.com/moustachauve/cookie-editor/blob/master/interface/options/options.js"
click node_devtools_ui "https://github.com/moustachauve/cookie-editor/blob/master/interface/devtools/devtools.js"
click node_mobile_ui "https://github.com/moustachauve/cookie-editor/blob/master/interface/popup-mobile/cookie-list.html"
click node_sidepanel_ui "https://github.com/moustachauve/cookie-editor/blob/master/interface/sidepanel/cookie-list.html"
click node_popup_handler "https://github.com/moustachauve/cookie-editor/blob/master/interface/popup/cookieHandlerPopup.js"
click node_devtools_handler "https://github.com/moustachauve/cookie-editor/blob/master/interface/devtools/cookieHandlerDevtools.js"
click node_generic_cookie "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/genericCookieHandler.js"
click node_cookie_record "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/cookie.js"
click node_formats "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/jsonFormat.js"
click node_header_format "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/headerstringFormat.js"
click node_permissions "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/permissionHandler.js"
click node_browser_detect "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/browserDetector.js"
click node_safari_bridge "https://github.com/moustachauve/cookie-editor/blob/master/safari/Cookie-Editor/Shared%20(Extension)/SafariWebExtensionHandler.swift"
click node_options_handler "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/optionsHandler.js"
click node_storage_handler "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/genericStorageHandler.js"
click node_theme_handler "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/themeHandler.js"
click node_ads "https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/ads/adHandler.js"

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_popup_ui,node_options_ui,node_devtools_ui,node_mobile_ui,node_sidepanel_ui,node_user toneBlue
class node_popup_handler,node_devtools_handler,node_generic_cookie,node_cookie_record,node_cookie_store,node_formats,node_header_format toneAmber
class node_options_handler,node_storage_handler,node_theme_handler,node_ads toneMint
class node_permissions,node_browser_detect,node_browser_api,node_safari_bridge toneRose
```

## Components

### Extension interfaces

- [Popup interface](https://github.com/moustachauve/cookie-editor/blob/master/interface/popup/cookie-list.js): `interface/popup/cookie-list.js`
- [Options page](https://github.com/moustachauve/cookie-editor/blob/master/interface/options/options.js): `interface/options/options.js`
- [DevTools panel](https://github.com/moustachauve/cookie-editor/blob/master/interface/devtools/devtools.js): `interface/devtools/devtools.js`
- [Mobile interface](https://github.com/moustachauve/cookie-editor/blob/master/interface/popup-mobile/cookie-list.html): `interface/popup-mobile/cookie-list.html`
- [Side panel](https://github.com/moustachauve/cookie-editor/blob/master/interface/sidepanel/cookie-list.html): `interface/sidepanel/cookie-list.html`

### Cookie management

- [Popup cookie handler](https://github.com/moustachauve/cookie-editor/blob/master/interface/popup/cookieHandlerPopup.js): `interface/popup/cookieHandlerPopup.js`
- [DevTools cookie handler](https://github.com/moustachauve/cookie-editor/blob/master/interface/devtools/cookieHandlerDevtools.js): `interface/devtools/cookieHandlerDevtools.js`
- [Cookie API handler](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/genericCookieHandler.js): `interface/lib/genericCookieHandler.js`
- [Cookie model](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/cookie.js): `interface/lib/cookie.js`
- **Browser cookie store**
- [Cookie formats](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/jsonFormat.js): `interface/lib/jsonFormat.js`
- [Header and Netscape formats](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/headerstringFormat.js): `interface/lib/headerstringFormat.js`

### Preferences and support

- [Options handler](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/optionsHandler.js): `interface/lib/optionsHandler.js`
- [Extension storage](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/genericStorageHandler.js): `interface/lib/genericStorageHandler.js`
- [Theme handler](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/themeHandler.js): `interface/lib/themeHandler.js`
- [Ad selection](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/ads/adHandler.js): `interface/lib/ads/adHandler.js`

### Browser platforms

- [Site permissions](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/permissionHandler.js): `interface/lib/permissionHandler.js`
- [Browser detection](https://github.com/moustachauve/cookie-editor/blob/master/interface/lib/browserDetector.js): `interface/lib/browserDetector.js`
- **Browser extension APIs**
- [Safari extension bridge](https://github.com/moustachauve/cookie-editor/blob/master/safari/Cookie-Editor/Shared%20(Extension)/SafariWebExtensionHandler.swift): `safari/Cookie-Editor/Shared (Extension)/SafariWebExtensionHandler.swift`

### Other components

- **Extension user**

## Connections

- Extension user → Popup interface: opens (evidence: `README.md`)
- Extension user → Options page: configures (evidence: `README.md`)
- Extension user → DevTools panel: opens
- Extension user → Mobile interface: uses (evidence: `README.md`)
- Popup interface → Popup cookie handler: manages cookies (evidence: `interface/popup/cookie-list.js`)
- Popup interface → Cookie model: renders (evidence: `interface/popup/cookie-list.js`)
- Popup interface → Site permissions: checks access (evidence: `interface/popup/cookie-list.js`)
- Popup interface → Options handler: loads preferences (evidence: `interface/popup/cookie-list.js`)
- Popup interface → Ad selection: selects ads (evidence: `interface/popup/cookie-list.js`)
- Options page → Popup cookie handler: deletes cookies (evidence: `interface/options/options.js`)
- Options page → Options handler: updates settings (evidence: `interface/options/options.js`)
- Options page → Theme handler: updates theme (evidence: `interface/options/options.js`)
- Options page → Cookie formats: exports JSON (evidence: `interface/options/options.js`)
- DevTools panel → DevTools cookie handler: manages cookies
- Popup cookie handler → Cookie API handler: extends (evidence: `interface/popup/cookieHandlerPopup.js`)
- DevTools cookie handler → Cookie API handler: extends (evidence: `interface/devtools/cookieHandlerDevtools.js`)
- DevTools cookie handler → Browser extension APIs: messages runtime (evidence: `interface/devtools/cookieHandlerDevtools.js`)
- Cookie API handler → Browser extension APIs: calls cookie API (evidence: `interface/lib/genericCookieHandler.js`)
- Browser extension APIs → Browser cookie store: reads and writes
- Browser detection → Browser extension APIs: provides API (evidence: `interface/lib/browserDetector.js`)
- Popup cookie handler → Browser extension APIs: tracks active tab (evidence: `interface/popup/cookieHandlerPopup.js`)
- Site permissions → Browser extension APIs: checks site access (evidence: `interface/lib/permissionHandler.js`)
- Popup interface → Header and Netscape formats: imports formats (evidence: `interface/popup/cookie-list.js`)
- Options handler → Extension storage: reads and saves (evidence: `interface/lib/optionsHandler.js`)
- Extension storage → Browser extension APIs: uses local storage (evidence: `interface/lib/genericStorageHandler.js`)
- Options handler → Browser extension APIs: notifies background (evidence: `interface/lib/optionsHandler.js`)
- Theme handler → Options handler: reads theme (evidence: `interface/lib/themeHandler.js`)
- Ad selection → Extension storage: checks dismissals (evidence: `interface/lib/ads/adHandler.js`)
- Ad selection → Browser detection: checks browser (evidence: `interface/lib/ads/adHandler.js`)
- Safari extension bridge → Browser extension APIs: bridges extension
- Mobile interface → Popup cookie handler: cookie workflow
- Side panel → Popup cookie handler: cookie workflow
