# d33ranked/directory-map architecture

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

- Interactive diagram: https://gitdiagram.com/d33ranked/directory-map
- Repository: https://github.com/d33ranked/directory-map

## Overview

DirTracker is a C++ directory-scanning and visualization application. Its principal workflow scans a root directory in the background, builds a navigable directory tree with file metadata and aggregate sizes, then presents the tree as a sunburst and file list. The excerpts show the scanner and navigation relationships, but omit parts of the main loop, so the graph does not assume how rendering is wired into it.

Main entry points: [`main.cpp`](https://github.com/d33ranked/directory-map/blob/main/main.cpp) (Directory Tracker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scan["Scanning"]
  node_tracker["Directory Tracker<br/>[main.cpp]"]
  node_scanner_manager["Scanner Manager<br/>[main.cpp]"]
  node_default_scanner["Default File Scanner<br/>[main.cpp]"]
end

subgraph group_tree["Directory Model"]
  node_directory_tree["Directory Tree<br/>[main.cpp]"]
end

subgraph group_view["Visualization"]
  node_visualizer["Sunburst and List<br/>[main.cpp]"]
end

node_user(("User"))
node_filesystem["Local Filesystem"]
node_entry["Application Entry<br/>[main.cpp]"]

node_entry -->|"starts scan"| node_tracker
node_tracker -->|"iterates entries"| node_filesystem
node_tracker -->|"scans files"| node_scanner_manager
node_scanner_manager -->|"fallback scans"| node_default_scanner
node_tracker -->|"builds and sizes"| node_directory_tree
node_visualizer -->|"renders tree"| node_directory_tree
node_user -->|"selects navigation"| node_visualizer
node_visualizer -->|"navigates view"| node_tracker

click node_entry "https://github.com/d33ranked/directory-map/blob/main/main.cpp"
click node_tracker "https://github.com/d33ranked/directory-map/blob/main/main.cpp"
click node_scanner_manager "https://github.com/d33ranked/directory-map/blob/main/main.cpp"
click node_default_scanner "https://github.com/d33ranked/directory-map/blob/main/main.cpp"
click node_directory_tree "https://github.com/d33ranked/directory-map/blob/main/main.cpp"
click node_visualizer "https://github.com/d33ranked/directory-map/blob/main/main.cpp"

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_tracker,node_scanner_manager,node_default_scanner,node_user toneBlue
class node_directory_tree toneAmber
class node_visualizer toneMint
class node_filesystem toneIndigo
class node_entry toneTeal
```

## Components

### Scanning

- [Directory Tracker](https://github.com/d33ranked/directory-map/blob/main/main.cpp): `main.cpp`
- [Scanner Manager](https://github.com/d33ranked/directory-map/blob/main/main.cpp): `main.cpp`
- [Default File Scanner](https://github.com/d33ranked/directory-map/blob/main/main.cpp): `main.cpp`

### Directory Model

- [Directory Tree](https://github.com/d33ranked/directory-map/blob/main/main.cpp): `main.cpp`

### Visualization

- [Sunburst and List](https://github.com/d33ranked/directory-map/blob/main/main.cpp): `main.cpp`

### Other components

- **User**
- **Local Filesystem**
- [Application Entry](https://github.com/d33ranked/directory-map/blob/main/main.cpp): `main.cpp`

## Connections

- Application Entry → Directory Tracker: starts scan (evidence: `main.cpp`)
- Directory Tracker → Local Filesystem: iterates entries (evidence: `main.cpp`)
- Directory Tracker → Scanner Manager: scans files (evidence: `main.cpp`)
- Scanner Manager → Default File Scanner: fallback scans (evidence: `main.cpp`)
- Directory Tracker → Directory Tree: builds and sizes (evidence: `main.cpp`)
- Sunburst and List → Directory Tree: renders tree (evidence: `main.cpp`)
- User → Sunburst and List: selects navigation (evidence: `main.cpp`)
- Sunburst and List → Directory Tracker: navigates view (evidence: `main.cpp`)
