# virtual0ps/zen-desktop architecture

> Architecture diagram of the GitHub repository virtual0ps/zen-desktop, 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/virtual0ps/zen-desktop
- Repository: https://github.com/virtual0ps/zen-desktop

## Overview

Zen is a Firefox-based desktop browser whose stated goal is productivity. The broad user workflow is browsing through Zen’s browser UI, with specialized features for organizing work, customizing the interface, and handling media and sharing. The tree and sampled files identify these feature areas, but most feature wiring was not shown; dashed, unverified links indicate likely user-facing entry points rather than confirmed calls. The README does not document individual feature workflows.

Main entry points: [`src/zen/common/modules/ZenUIManager.mjs`](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/common/modules/ZenUIManager.mjs) (UI manager), [`src/browser/components/preferences/zen-settings.js`](https://github.com/virtual0ps/zen-desktop/blob/dev/src/browser/components/preferences/zen-settings.js) (Preferences), [`src/zen/spaces/ZenSpaceManager.mjs`](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/spaces/ZenSpaceManager.mjs) (Spaces manager), [`src/zen/folders/ZenFolders.mjs`](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/folders/ZenFolders.mjs) (Folders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Browser UI"]
  node_ui_manager["UI manager<br/>[ZenUIManager.mjs]"]
  node_settings["Preferences<br/>[zen-settings.js]"]
end

subgraph group_work["Workspace organization"]
  node_spaces["Spaces manager"]
  node_folders["Folders<br/>[ZenFolders.mjs]"]
  node_pinned["Pinned tabs"]
  node_routing["Space routing"]
  node_split["Split view"]
end

subgraph group_custom["Customization"]
  node_boosts["Boosts"]
  node_mods["Mods<br/>[ZenMods.mjs]"]
  node_compact["Compact mode<br/>[ZenCompactMode.mjs]"]
end

subgraph group_features["Browser features"]
  node_glance["Glance views"]
  node_library["Library<br/>[ZenLibrary.mjs]"]
  node_media["Media controls"]
  node_share["Sharing"]
  node_livefolders["Live folders"]
end

subgraph group_sync["Persistence and sync"]
  node_session["Session manager"]
  node_spaces_sync["Spaces sync"]
  node_bookmarks[("Space bookmarks")]
end

node_user(("Browser user"))

node_user -.->|"uses browser UI"| node_ui_manager
node_user -.->|"configures browser"| node_settings
node_user -.->|"organizes work"| node_spaces
node_user -.->|"organizes tabs"| node_folders
node_user -.->|"uses pinned tabs"| node_pinned
node_user -.->|"routes browsing"| node_routing
node_user -.->|"views side by side"| node_split
node_user -.->|"opens glance views"| node_glance
node_user -.->|"browses library"| node_library
node_user -.->|"controls media"| node_media
node_user -.->|"shares content"| node_share
node_user -.->|"uses live folders"| node_livefolders
node_user -.->|"customizes pages"| node_boosts
node_user -.->|"customizes browser"| node_mods
node_user -.->|"changes layout"| node_compact
node_user -.->|"restores sessions"| node_session
node_user -.->|"syncs spaces"| node_spaces_sync

click node_ui_manager "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/common/modules/ZenUIManager.mjs"
click node_settings "https://github.com/virtual0ps/zen-desktop/blob/dev/src/browser/components/preferences/zen-settings.js"
click node_spaces "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/spaces/ZenSpaceManager.mjs"
click node_folders "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/folders/ZenFolders.mjs"
click node_pinned "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/tabs/ZenPinnedTabManager.mjs"
click node_routing "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/space-routing/ZenSpaceRoutingManager.sys.mjs"
click node_split "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/split-view/ZenViewSplitter.mjs"
click node_glance "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/glance/ZenGlanceManager.mjs"
click node_library "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/library/ZenLibrary.mjs"
click node_media "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/media/ZenMediaController.mjs"
click node_share "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/share/ZenShareManager.mjs"
click node_livefolders "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/live-folders/ZenLiveFoldersManager.sys.mjs"
click node_boosts "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/boosts/ZenBoostsManager.sys.mjs"
click node_mods "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/mods/ZenMods.mjs"
click node_compact "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/compact-mode/ZenCompactMode.mjs"
click node_session "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/sessionstore/ZenSessionManager.sys.mjs"
click node_spaces_sync "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/sync/ZenSpacesSyncApplier.sys.mjs"
click node_bookmarks "https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/spaces/ZenSpaceBookmarksStorage.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_ui_manager,node_settings,node_user toneBlue
class node_spaces,node_folders,node_pinned,node_routing,node_split toneAmber
class node_boosts,node_mods,node_compact toneMint
class node_glance,node_library,node_media,node_share,node_livefolders toneRose
class node_session,node_spaces_sync,node_bookmarks toneIndigo
```

## Components

### Browser UI

- [UI manager](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/common/modules/ZenUIManager.mjs): `src/zen/common/modules/ZenUIManager.mjs`
- [Preferences](https://github.com/virtual0ps/zen-desktop/blob/dev/src/browser/components/preferences/zen-settings.js): `src/browser/components/preferences/zen-settings.js`

### Workspace organization

- [Spaces manager](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/spaces/ZenSpaceManager.mjs): `src/zen/spaces/ZenSpaceManager.mjs`
- [Folders](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/folders/ZenFolders.mjs): `src/zen/folders/ZenFolders.mjs`
- [Pinned tabs](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/tabs/ZenPinnedTabManager.mjs): `src/zen/tabs/ZenPinnedTabManager.mjs`
- [Space routing](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/space-routing/ZenSpaceRoutingManager.sys.mjs): `src/zen/space-routing/ZenSpaceRoutingManager.sys.mjs`
- [Split view](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/split-view/ZenViewSplitter.mjs): `src/zen/split-view/ZenViewSplitter.mjs`

### Customization

- [Boosts](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/boosts/ZenBoostsManager.sys.mjs): `src/zen/boosts/ZenBoostsManager.sys.mjs`
- [Mods](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/mods/ZenMods.mjs): `src/zen/mods/ZenMods.mjs`
- [Compact mode](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/compact-mode/ZenCompactMode.mjs): `src/zen/compact-mode/ZenCompactMode.mjs`

### Browser features

- [Glance views](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/glance/ZenGlanceManager.mjs): `src/zen/glance/ZenGlanceManager.mjs`
- [Library](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/library/ZenLibrary.mjs): `src/zen/library/ZenLibrary.mjs`
- [Media controls](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/media/ZenMediaController.mjs): `src/zen/media/ZenMediaController.mjs`
- [Sharing](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/share/ZenShareManager.mjs): `src/zen/share/ZenShareManager.mjs`
- [Live folders](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/live-folders/ZenLiveFoldersManager.sys.mjs): `src/zen/live-folders/ZenLiveFoldersManager.sys.mjs`

### Persistence and sync

- [Session manager](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/sessionstore/ZenSessionManager.sys.mjs): `src/zen/sessionstore/ZenSessionManager.sys.mjs`
- [Spaces sync](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/sync/ZenSpacesSyncApplier.sys.mjs): `src/zen/sync/ZenSpacesSyncApplier.sys.mjs`
- [Space bookmarks](https://github.com/virtual0ps/zen-desktop/blob/dev/src/zen/spaces/ZenSpaceBookmarksStorage.js): `src/zen/spaces/ZenSpaceBookmarksStorage.js`

### Other components

- **Browser user**

## Connections

- Browser user → UI manager: uses browser UI (evidence: `README.md`)
- Browser user → Preferences: configures browser
- Browser user → Spaces manager: organizes work
- Browser user → Folders: organizes tabs
- Browser user → Pinned tabs: uses pinned tabs
- Browser user → Space routing: routes browsing
- Browser user → Split view: views side by side
- Browser user → Glance views: opens glance views
- Browser user → Library: browses library
- Browser user → Media controls: controls media
- Browser user → Sharing: shares content
- Browser user → Live folders: uses live folders
- Browser user → Boosts: customizes pages
- Browser user → Mods: customizes browser
- Browser user → Compact mode: changes layout
- Browser user → Session manager: restores sessions
- Browser user → Spaces sync: syncs spaces
