# tnvr-hsn/stack-dock architecture

> Architecture diagram of the GitHub repository tnvr-hsn/stack-dock, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tnvr-hsn/stack-dock
- Repository: https://github.com/tnvr-hsn/stack-dock

## Overview

StackDock is a customizable Windows dock for launching and organizing shortcuts in expandable grid stacks. The user-facing flow is to add or drop shortcuts, arrange them on the dock or in grids, and activate them; settings and layout backups support customization and recovery. The repository shows a JavaScript dock runtime alongside Tauri/Rust Windows integrations. The sampled React App is still the Tauri starter screen, so it is not treated as the product UI. Some subsystem connections are documented in the README rather than visible in the sampled implementation.

Main entry points: [`src-tauri/src/lib.rs`](https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/lib.rs) (Tauri commands), [`public/stack-dock-native.js`](https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-native.js) (Dock and grids), [`public/stack-dock-panels.js`](https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-panels.js) (Settings panels), [`src-tauri/src/native_shortcuts.rs`](https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/native_shortcuts.rs) (Shortcut resources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dock["Dock experience"]
  node_runtime["Dock and grids"]
  node_visuals["Dock visuals"]
end

subgraph group_custom["Editing and customization"]
  node_shortcut_edit["Shortcut editor"]
  node_settings["Settings panels"]
  node_layout[("Layout storage")]
end

subgraph group_native["Windows integration"]
  node_native_bridge["Tauri commands<br/>[lib.rs]"]
  node_shortcut_native["Shortcut resources"]
  node_file_drop["Explorer file drop<br/>[file_drop.rs]"]
  node_widget_native["Window and taskbar<br/>[desktop_widget.rs]"]
end

node_user(("Dock user"))
node_windows(("Windows"))

node_user -->|"uses dock"| node_runtime
node_user -->|"edits shortcuts"| node_shortcut_edit
node_user -->|"customizes dock"| node_settings
node_runtime -->|"renders with"| node_visuals
node_runtime -->|"saves layout"| node_layout
node_shortcut_edit -->|"updates layout"| node_layout
node_settings -->|"customizes layout"| node_layout
node_runtime -->|"invokes commands"| node_native_bridge
node_native_bridge -.->|"uses shortcut support"| node_shortcut_native
node_native_bridge -.->|"supports file drops"| node_file_drop
node_native_bridge -.->|"manages dock window"| node_widget_native
node_native_bridge -->|"controls Windows"| node_windows
node_shortcut_native -->|"reads native icons"| node_windows
node_file_drop -->|"receives Explorer drops"| node_windows
node_widget_native -->|"manages window state"| node_windows

click node_runtime "https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-native.js"
click node_visuals "https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-widget.js"
click node_shortcut_edit "https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-native.js"
click node_settings "https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-panels.js"
click node_layout "https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-native.js"
click node_native_bridge "https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/lib.rs"
click node_shortcut_native "https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/native_shortcuts.rs"
click node_file_drop "https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/file_drop.rs"
click node_widget_native "https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/desktop_widget.rs"

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_runtime,node_visuals,node_user toneBlue
class node_shortcut_edit,node_settings,node_layout toneAmber
class node_native_bridge,node_shortcut_native,node_file_drop,node_widget_native toneMint
class node_windows toneIndigo
```

## Components

### Dock experience

- [Dock and grids](https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-native.js): `public/stack-dock-native.js`
- [Dock visuals](https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-widget.js): `public/stack-dock-widget.js`

### Editing and customization

- [Shortcut editor](https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-native.js): `public/stack-dock-native.js`
- [Settings panels](https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-panels.js): `public/stack-dock-panels.js`
- [Layout storage](https://github.com/tnvr-hsn/stack-dock/blob/main/public/stack-dock-native.js): `public/stack-dock-native.js`

### Windows integration

- [Tauri commands](https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Shortcut resources](https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/native_shortcuts.rs): `src-tauri/src/native_shortcuts.rs`
- [Explorer file drop](https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/file_drop.rs): `src-tauri/src/file_drop.rs`
- [Window and taskbar](https://github.com/tnvr-hsn/stack-dock/blob/main/src-tauri/src/desktop_widget.rs): `src-tauri/src/desktop_widget.rs`

### Other components

- **Dock user**
- **Windows**

## Connections

- Dock user → Dock and grids: uses dock (evidence: `README.md`)
- Dock user → Shortcut editor: edits shortcuts (evidence: `README.md`)
- Dock user → Settings panels: customizes dock (evidence: `README.md`)
- Dock and grids → Dock visuals: renders with (evidence: `public/stack-dock-widget.js`)
- Dock and grids → Layout storage: saves layout (evidence: `public/stack-dock-native.js`)
- Shortcut editor → Layout storage: updates layout (evidence: `public/stack-dock-native.js`)
- Settings panels → Layout storage: customizes layout (evidence: `README.md`)
- Dock and grids → Tauri commands: invokes commands (evidence: `public/stack-dock-native.js`)
- Tauri commands → Shortcut resources: uses shortcut support (evidence: `src-tauri/src/lib.rs`)
- Tauri commands → Explorer file drop: supports file drops (evidence: `src-tauri/src/lib.rs`)
- Tauri commands → Window and taskbar: manages dock window (evidence: `src-tauri/src/lib.rs`)
- Tauri commands → Windows: controls Windows (evidence: `src-tauri/src/lib.rs`)
- Shortcut resources → Windows: reads native icons (evidence: `src-tauri/src/native_shortcuts.rs`)
- Explorer file drop → Windows: receives Explorer drops (evidence: `src-tauri/src/file_drop.rs`)
- Window and taskbar → Windows: manages window state (evidence: `src-tauri/src/desktop_widget.rs`)
