# tobi/disktree architecture

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

- Interactive diagram: https://gitdiagram.com/tobi/disktree
- Repository: https://github.com/tobi/disktree

## Overview

disktree is a desktop disk-usage explorer and cleanup tool. Its main workflow scans a chosen directory or volume, builds and classifies a size-aware tree, presents it as an interactive treemap, then lets users mark paths, review the projected space recovery, and move items to trash or delete them permanently. The graph also preserves the documented Git checkout details, findings, volume selection, and platform-specific scan/removal support. Some connections use README evidence because the relevant implementation excerpts are incomplete.

Main entry points: [`crates/disktree-app/src/state.rs`](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/state.rs) (App state), [`crates/disktree-app/src/views.rs`](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/views.rs) (Screens), [`crates/disktree-core/src/scan.rs`](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/scan.rs) (Filesystem scan), [`crates/disktree-core/src/removal.rs`](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/removal.rs) (Trash and deletion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop experience"]
  node_app_entry["App entry<br/>[main.rs]"]
  node_app_state["App state<br/>[state.rs]"]
  node_screens["Screens<br/>[views.rs]"]
  node_tile_view["Treemap canvas<br/>[treemap_view.rs]"]
  node_widgets["Shared widgets<br/>[widgets.rs]"]
  node_palette["Theme palette<br/>[palette.rs]"]
end

subgraph group_scan["Scanning and model"]
  node_scan_engine["Filesystem scan<br/>[scan.rs]"]
  node_tree["Measured tree<br/>[tree.rs]"]
  node_classification["Kind and reclaim<br/>[classify.rs]"]
  node_ntfs_scan["NTFS MFT scan<br/>[mft.rs]"]
  node_platform_fs["Platform filesystem<br/>[windows.rs]"]
end

subgraph group_explore["Explore and insights"]
  node_filtering["Tree filtering<br/>[filter.rs]"]
  node_treemap_layout["Treemap layout<br/>[treemap.rs]"]
  node_insights["Cleanup findings<br/>[insights.rs]"]
  node_git_status["Git checkout status<br/>[git.rs]"]
end

subgraph group_cleanup["Review and removal"]
  node_space["Volume space<br/>[space.rs]"]
  node_marks["Marked paths<br/>[marks.rs]"]
  node_removal["Trash and deletion<br/>[removal.rs]"]
end

node_user(("User"))
node_filesystem["Scanned filesystem"]
node_volume[("Disk volume")]
node_git["Git repositories"]

node_user -->|"launches"| node_app_entry
node_app_entry -->|"starts app"| node_app_state
node_app_state -->|"starts scan"| node_scan_engine
node_scan_engine -->|"reads entries"| node_filesystem
node_scan_engine -->|"builds tree"| node_tree
node_scan_engine -->|"classifies entries"| node_classification
node_scan_engine -->|"uses MFT scan"| node_ntfs_scan
node_scan_engine -->|"uses platform APIs"| node_platform_fs
node_tree -->|"classifies descendants"| node_classification
node_app_state -->|"drives screens"| node_screens
node_screens -->|"renders treemap"| node_tile_view
node_screens -->|"uses components"| node_widgets
node_tile_view -->|"uses colors"| node_palette
node_app_state -.->|"filters tree"| node_filtering
node_app_state -.->|"lays out tiles"| node_treemap_layout
node_screens -->|"shows findings"| node_insights
node_screens -->|"shows checkout"| node_git_status
node_git_status -->|"reads status"| node_git
node_app_state -->|"updates marks"| node_marks
node_screens -->|"reviews marks"| node_marks
node_app_state -->|"measures volume"| node_space
node_space -->|"queries capacity"| node_volume
node_app_state -->|"commits removal"| node_removal
node_removal -->|"moves or deletes"| node_filesystem
node_removal -.->|"updates projection"| node_space

click node_app_entry "https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/main.rs"
click node_app_state "https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/state.rs"
click node_screens "https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/views.rs"
click node_tile_view "https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/treemap_view.rs"
click node_widgets "https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/widgets.rs"
click node_palette "https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/palette.rs"
click node_scan_engine "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/scan.rs"
click node_tree "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/tree.rs"
click node_classification "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/classify.rs"
click node_ntfs_scan "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/mft.rs"
click node_platform_fs "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/windows.rs"
click node_filtering "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/filter.rs"
click node_treemap_layout "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/treemap.rs"
click node_insights "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/insights.rs"
click node_git_status "https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/git.rs"
click node_space "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/space.rs"
click node_marks "https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/marks.rs"
click node_removal "https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/removal.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_app_entry,node_app_state,node_screens,node_tile_view,node_widgets,node_palette,node_user toneBlue
class node_scan_engine,node_tree,node_classification,node_ntfs_scan,node_platform_fs,node_volume toneAmber
class node_filtering,node_treemap_layout,node_insights,node_git_status toneMint
class node_space,node_marks,node_removal toneRose
class node_filesystem,node_git toneIndigo
```

## Components

### Desktop experience

- [App entry](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/main.rs): `crates/disktree-app/src/main.rs`
- [App state](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/state.rs): `crates/disktree-app/src/state.rs`
- [Screens](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/views.rs): `crates/disktree-app/src/views.rs`
- [Treemap canvas](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/treemap_view.rs): `crates/disktree-app/src/treemap_view.rs`
- [Shared widgets](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/widgets.rs): `crates/disktree-app/src/widgets.rs`
- [Theme palette](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/palette.rs): `crates/disktree-app/src/palette.rs`

### Scanning and model

- [Filesystem scan](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/scan.rs): `crates/disktree-core/src/scan.rs`
- [Measured tree](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/tree.rs): `crates/disktree-core/src/tree.rs`
- [Kind and reclaim](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/classify.rs): `crates/disktree-core/src/classify.rs`
- [NTFS MFT scan](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/mft.rs): `crates/disktree-core/src/mft.rs`
- [Platform filesystem](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/windows.rs): `crates/disktree-core/src/windows.rs`

### Explore and insights

- [Tree filtering](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/filter.rs): `crates/disktree-core/src/filter.rs`
- [Treemap layout](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/treemap.rs): `crates/disktree-core/src/treemap.rs`
- [Cleanup findings](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/insights.rs): `crates/disktree-core/src/insights.rs`
- [Git checkout status](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/git.rs): `crates/disktree-app/src/git.rs`

### Review and removal

- [Volume space](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/space.rs): `crates/disktree-core/src/space.rs`
- [Marked paths](https://github.com/tobi/disktree/blob/main/crates/disktree-app/src/marks.rs): `crates/disktree-app/src/marks.rs`
- [Trash and deletion](https://github.com/tobi/disktree/blob/main/crates/disktree-core/src/removal.rs): `crates/disktree-core/src/removal.rs`

### Other components

- **User**
- **Scanned filesystem**
- **Disk volume**
- **Git repositories**

## Connections

- User → App entry: launches (evidence: `README.md`)
- App entry → App state: starts app (evidence: `crates/disktree-app/src/main.rs`)
- App state → Filesystem scan: starts scan (evidence: `README.md`)
- Filesystem scan → Scanned filesystem: reads entries (evidence: `crates/disktree-core/src/scan.rs`)
- Filesystem scan → Measured tree: builds tree (evidence: `crates/disktree-core/src/scan.rs`)
- Filesystem scan → Kind and reclaim: classifies entries (evidence: `crates/disktree-core/src/scan.rs`)
- Filesystem scan → NTFS MFT scan: uses MFT scan (evidence: `crates/disktree-core/src/scan.rs`)
- Filesystem scan → Platform filesystem: uses platform APIs (evidence: `crates/disktree-core/src/scan.rs`)
- Measured tree → Kind and reclaim: classifies descendants (evidence: `crates/disktree-core/src/tree.rs`)
- App state → Screens: drives screens (evidence: `crates/disktree-app/src/state.rs`)
- Screens → Treemap canvas: renders treemap (evidence: `crates/disktree-app/src/views.rs`)
- Screens → Shared widgets: uses components (evidence: `crates/disktree-app/src/views.rs`)
- Treemap canvas → Theme palette: uses colors (evidence: `crates/disktree-app/src/treemap_view.rs`)
- App state → Tree filtering: filters tree
- App state → Treemap layout: lays out tiles
- Screens → Cleanup findings: shows findings (evidence: `crates/disktree-app/src/views.rs`)
- Screens → Git checkout status: shows checkout (evidence: `crates/disktree-app/src/views.rs`)
- Git checkout status → Git repositories: reads status (evidence: `README.md`)
- App state → Marked paths: updates marks (evidence: `crates/disktree-app/src/state.rs`)
- Screens → Marked paths: reviews marks (evidence: `crates/disktree-app/src/views.rs`)
- App state → Volume space: measures volume (evidence: `README.md`)
- Volume space → Disk volume: queries capacity (evidence: `crates/disktree-core/src/space.rs`)
- App state → Trash and deletion: commits removal (evidence: `README.md`)
- Trash and deletion → Scanned filesystem: moves or deletes (evidence: `crates/disktree-core/src/removal.rs`)
- Trash and deletion → Volume space: updates projection (evidence: `crates/disktree-core/src/removal.rs`)
