# home-sweet-gnome/dash-to-panel architecture

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

- Interactive diagram: https://gitdiagram.com/home-sweet-gnome/dash-to-panel
- Repository: https://github.com/home-sweet-gnome/dash-to-panel

## Overview

Dash to Panel is a GNOME Shell extension that combines launchers, running applications, and system controls in a configurable panel. The main runtime path initializes settings and a panel manager, which creates per-monitor panels and taskbars; taskbar icons support app/window actions and previews. Additional branches implement overview shortcuts, intelligent hiding, transparency, and desktop-icon integration. Paths and edges are limited to the supplied tree, README statements, and source references; unsampled feature wiring is represented only where documented.

Main entry points: [`src/panelManager.js`](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelManager.js) (Panel manager), [`src/panel.js`](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panel.js) (Per-monitor panel), [`src/extension.js`](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/extension.js) (Extension lifecycle), [`src/intellihide.js`](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/intellihide.js) (Intellihide)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Extension runtime"]
  node_entry["Extension lifecycle<br/>[extension.js]"]
  node_manager["Panel manager<br/>[panelManager.js]"]
  node_notifications["Notification monitor"]
  node_desktop["Desktop icon integration"]
  node_utils["Shell utilities<br/>[utils.js]"]
end

subgraph group_panel["Panel and taskbar"]
  node_panel["Per-monitor panel<br/>[panel.js]"]
  node_taskbar["Taskbar<br/>[taskbar.js]"]
  node_icons["Application icons<br/>[appIcons.js]"]
  node_preview["Window previews<br/>[windowPreview.js]"]
  node_style["Panel styling<br/>[panelStyle.js]"]
end

subgraph group_behavior["Workspace behavior"]
  node_overview["Overview shortcuts<br/>[overview.js]"]
  node_intellihide["Intellihide<br/>[intellihide.js]"]
  node_proximity["Window proximity<br/>[proximity.js]"]
  node_transparency["Dynamic transparency<br/>[transparency.js]"]
  node_pointer["Pointer watcher<br/>[pointerWatcher.js]"]
end

subgraph group_settings["Configuration"]
  node_positions["Panel positions<br/>[panelPositions.js]"]
  node_settingslogic["Settings logic<br/>[panelSettings.js]"]
  node_preferences["Preferences UI<br/>[prefs.js]"]
  node_schema["Settings schema"]
end

node_user(("GNOME user"))
node_gnome["GNOME Shell"]
node_windowmanager["Window manager"]
node_display["Display configuration"]

node_user -->|"uses"| node_gnome
node_gnome -->|"loads extension"| node_entry
node_entry -->|"initializes"| node_settingslogic
node_entry -->|"creates"| node_manager
node_manager -->|"manages"| node_panel
node_manager -->|"constructs"| node_overview
node_manager -->|"integrates"| node_desktop
node_manager -->|"manages"| node_notifications
node_panel -.->|"hosts"| node_taskbar
node_taskbar -->|"creates"| node_icons
node_taskbar -->|"uses"| node_preview
node_panel -->|"uses"| node_style
node_panel -->|"uses"| node_positions
node_settingslogic -->|"uses"| node_positions
node_preferences -->|"uses"| node_settingslogic
node_preferences -.->|"configures"| node_schema
node_panel -->|"uses"| node_intellihide
node_intellihide -->|"creates watches"| node_proximity
node_intellihide -->|"watches pointer"| node_pointer
node_panel -->|"uses"| node_transparency
node_transparency -->|"uses"| node_proximity
node_overview -->|"reads"| node_taskbar
node_manager -->|"patches overview"| node_windowmanager
node_settingslogic -->|"reads monitor state"| node_display
node_entry -->|"uses"| node_utils
node_intellihide -->|"uses"| node_utils

click node_entry "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/extension.js"
click node_manager "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelManager.js"
click node_notifications "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/notificationsMonitor.js"
click node_desktop "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/desktopIconsIntegration.js"
click node_panel "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panel.js"
click node_taskbar "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/taskbar.js"
click node_icons "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/appIcons.js"
click node_preview "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/windowPreview.js"
click node_style "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelStyle.js"
click node_positions "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelPositions.js"
click node_settingslogic "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelSettings.js"
click node_preferences "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/prefs.js"
click node_schema "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/schemas/org.gnome.shell.extensions.dash-to-panel.gschema.xml"
click node_overview "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/overview.js"
click node_intellihide "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/intellihide.js"
click node_proximity "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/proximity.js"
click node_transparency "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/transparency.js"
click node_utils "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/utils.js"
click node_pointer "https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/pointerWatcher.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_entry,node_manager,node_notifications,node_desktop,node_utils,node_user toneBlue
class node_panel,node_taskbar,node_icons,node_preview,node_style toneAmber
class node_overview,node_intellihide,node_proximity,node_transparency,node_pointer toneMint
class node_positions,node_settingslogic,node_preferences,node_schema toneRose
class node_gnome,node_windowmanager,node_display toneIndigo
```

## Components

### Extension runtime

- [Extension lifecycle](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/extension.js): `src/extension.js`
- [Panel manager](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelManager.js): `src/panelManager.js`
- [Notification monitor](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/notificationsMonitor.js): `src/notificationsMonitor.js`
- [Desktop icon integration](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/desktopIconsIntegration.js): `src/desktopIconsIntegration.js`
- [Shell utilities](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/utils.js): `src/utils.js`

### Panel and taskbar

- [Per-monitor panel](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panel.js): `src/panel.js`
- [Taskbar](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/taskbar.js): `src/taskbar.js`
- [Application icons](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/appIcons.js): `src/appIcons.js`
- [Window previews](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/windowPreview.js): `src/windowPreview.js`
- [Panel styling](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelStyle.js): `src/panelStyle.js`

### Workspace behavior

- [Overview shortcuts](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/overview.js): `src/overview.js`
- [Intellihide](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/intellihide.js): `src/intellihide.js`
- [Window proximity](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/proximity.js): `src/proximity.js`
- [Dynamic transparency](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/transparency.js): `src/transparency.js`
- [Pointer watcher](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/pointerWatcher.js): `src/pointerWatcher.js`

### Configuration

- [Panel positions](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelPositions.js): `src/panelPositions.js`
- [Settings logic](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/panelSettings.js): `src/panelSettings.js`
- [Preferences UI](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/src/prefs.js): `src/prefs.js`
- [Settings schema](https://github.com/home-sweet-gnome/dash-to-panel/blob/master/schemas/org.gnome.shell.extensions.dash-to-panel.gschema.xml): `schemas/org.gnome.shell.extensions.dash-to-panel.gschema.xml`

### Other components

- **GNOME user**
- **GNOME Shell**
- **Window manager**
- **Display configuration**

## Connections

- GNOME user → GNOME Shell: uses (evidence: `README.md`)
- GNOME Shell → Extension lifecycle: loads extension (evidence: `src/extension.js`)
- Extension lifecycle → Settings logic: initializes (evidence: `src/extension.js`)
- Extension lifecycle → Panel manager: creates (evidence: `src/extension.js`)
- Panel manager → Per-monitor panel: manages (evidence: `src/panelManager.js`)
- Panel manager → Overview shortcuts: constructs (evidence: `src/panelManager.js`)
- Panel manager → Desktop icon integration: integrates (evidence: `src/panelManager.js`)
- Panel manager → Notification monitor: manages (evidence: `src/panelManager.js`)
- Per-monitor panel → Taskbar: hosts (evidence: `src/panel.js`)
- Taskbar → Application icons: creates (evidence: `src/taskbar.js`)
- Taskbar → Window previews: uses (evidence: `src/taskbar.js`)
- Per-monitor panel → Panel styling: uses (evidence: `src/panel.js`)
- Per-monitor panel → Panel positions: uses (evidence: `src/panel.js`)
- Settings logic → Panel positions: uses (evidence: `src/panelSettings.js`)
- Preferences UI → Settings logic: uses (evidence: `src/prefs.js`)
- Preferences UI → Settings schema: configures
- Per-monitor panel → Intellihide: uses (evidence: `src/panel.js`)
- Intellihide → Window proximity: creates watches (evidence: `src/intellihide.js`)
- Intellihide → Pointer watcher: watches pointer (evidence: `src/intellihide.js`)
- Per-monitor panel → Dynamic transparency: uses (evidence: `src/panel.js`)
- Dynamic transparency → Window proximity: uses (evidence: `src/transparency.js`)
- Overview shortcuts → Taskbar: reads (evidence: `src/overview.js`)
- Panel manager → Window manager: patches overview (evidence: `src/panelManager.js`)
- Settings logic → Display configuration: reads monitor state (evidence: `src/panelSettings.js`)
- Extension lifecycle → Shell utilities: uses (evidence: `src/extension.js`)
- Intellihide → Shell utilities: uses (evidence: `src/intellihide.js`)
