How zen-browser/desktop works
Zen is a Firefox-based desktop browser focused on productivity. Its principal user workflow is interacting with browser UI to organize spaces and tabs, navigate or route links, and use browsing features such as split view, glance, media, and the library; session and sync modules support continuity. The tree exposes these product areas, but most implementation excerpts do not show their runtime wiring. Dashed edges therefore mark unverified workflow links rather than asserted calls.
Main entry points: ZenSpaceManager.mjs Spaces · ZenUIManager.mjs UI manager · ZenSpaceRoutingManager.sys.mjs Space routing · ZenSpacesSync.sys.mjs Spaces sync
Components 21
Browser UI
- UI manager
src/zen/common/modules/ZenUIManager.mjs - Preferences
src/browser/components/preferences/zen-settings.js - Compact mode
src/zen/compact-mode/ZenCompactMode.mjs - Keyboard shortcuts
src/zen/kbs/ZenKeyboardShortcuts.mjs
Spaces And Tabs
- Spaces
src/zen/spaces/ZenSpaceManager.mjs - Space creation
src/zen/spaces/ZenSpaceCreation.mjs - Folders
src/zen/folders/ZenFolders.mjs - Pinned tabs
src/zen/tabs/ZenPinnedTabManager.mjs - Split view
src/zen/split-view/ZenViewSplitter.mjs
Navigation Features
- Space routing
src/zen/space-routing/ZenSpaceRoutingManager.sys.mjs - Routing dialog
src/zen/space-routing/ZenSpaceRoutingDialog.mjs - Glance
src/zen/glance/ZenGlanceManager.mjs - URL bar actions
src/zen/urlbar/ZenUBActionsProvider.sys.mjs
Browsing Tools
- Library
src/zen/library/ZenLibrary.mjs - Live folders
src/zen/live-folders/ZenLiveFoldersManager.sys.mjs - Media controls
src/zen/media/ZenMediaController.mjs - Boosts
src/zen/boosts/ZenBoostsManager.sys.mjs
State And Sync
- Session manager
src/zen/sessionstore/ZenSessionManager.sys.mjs - Space bookmarks
src/zen/spaces/ZenSpaceBookmarksStorage.js - Spaces sync
src/zen/sync/ZenSpacesSync.sys.mjs
Other components
- Browser user
Connections 15
- Browser user → UI manager: uses
- Browser user → Preferences: configures
- Browser user → Spaces: organizes
- Browser user → Space routing: routes links
- Browser user → Library: browses library
- Browser user → Split view: uses
- Spaces → Space creation: supports
- Spaces → Folders: organizes
- Spaces → Pinned tabs: organizes
- Spaces → Space bookmarks: persists
- Spaces → Spaces sync: syncs
- Space routing → Routing dialog: presents
- UI manager → Compact mode: coordinates
- UI manager → Keyboard shortcuts: coordinates
- Session manager → Spaces sync: preserves state