# janecea/filesurfer architecture

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

- Interactive diagram: https://gitdiagram.com/janecea/filesurfer
- Repository: https://github.com/janecea/filesurfer

## Overview

FileSurfer is a cross-platform desktop file explorer. The user-facing workflow is to browse a location, inspect entries, and perform file actions; additional documented capabilities include recursive search, clipboard paste, batch rename, undo/redo, Git, SFTP, and local-to-remote synchronization. The graph combines sampled UI and service wiring with README-described capabilities. Several feature implementations were not sampled, so their internal call paths are not asserted.

Main entry points: [`src/FileSurfer.Windows/Program.cs`](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Windows/Program.cs) (Windows app), [`src/FileSurfer.Linux/Program.cs`](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Linux/Program.cs) (Linux app), [`src/FileSurfer.Core/ViewModels/MainWindowViewModel.cs`](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/ViewModels/MainWindowViewModel.cs) (Explorer state), [`src/FileSurfer.Core/Views/MainWindow.axaml.cs`](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Views/MainWindow.axaml.cs) (Explorer window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop UI"]
  node_main_view["Explorer window"]
  node_main_vm["Explorer state"]
  node_entry_vm["Entry presentation"]
  node_search["Recursive search<br/>[SearchManager.cs]"]
end

subgraph group_core["File browsing"]
  node_settings["User settings"]
  node_fs_contract["Filesystem abstraction<br/>[IFileSystem.cs]"]
  node_entry_model["File entries"]
  node_local_info["Local metadata"]
end

subgraph group_ops["File operations"]
  node_file_ops["File operations<br/>[FileOperations.cs]"]
  node_clipboard["Clipboard paste"]
  node_archive["Archive handling"]
  node_undo["Undo and redo<br/>[UndoRedoHandler.cs]"]
end

subgraph group_remote["Remote and integrations"]
  node_git["Git integration"]
  node_sftp_fs["SFTP filesystem"]
  node_sftp_io["SFTP file I/O"]
  node_sync["Directory sync"]
end

subgraph group_platform["Platform adapters"]
  node_linux_app["Linux app<br/>[Program.cs]"]
  node_windows_app["Windows app<br/>[Program.cs]"]
  node_local_io_linux["Linux file I/O"]
  node_local_io_windows["Windows file I/O"]
end

node_user(("User"))

node_user -->|"uses"| node_main_view
node_linux_app -->|"starts"| node_main_vm
node_windows_app -->|"starts"| node_main_vm
node_main_view -->|"binds to"| node_main_vm
node_main_vm -->|"creates"| node_search
node_search -->|"enumerates"| node_fs_contract
node_search -->|"creates"| node_entry_vm
node_linux_app -->|"configures"| node_local_io_linux
node_windows_app -->|"configures"| node_local_io_windows
node_linux_app -->|"configures"| node_git
node_windows_app -->|"configures"| node_git
node_linux_app -->|"configures"| node_clipboard
node_windows_app -->|"configures"| node_clipboard
node_linux_app -->|"configures"| node_archive
node_windows_app -->|"configures"| node_archive
node_windows_app -->|"configures"| node_sftp_fs
node_main_view -->|"uses"| node_settings
node_user -->|"manages files"| node_file_ops
node_user -->|"pastes content"| node_clipboard
node_user -->|"reverses actions"| node_undo
node_user -->|"uses Git"| node_git
node_user -->|"browses remotely"| node_sftp_fs
node_user -->|"synchronizes folders"| node_sync
node_file_ops -.->|"uses I/O"| node_local_io_linux
node_file_ops -.->|"uses I/O"| node_local_io_windows
node_sftp_fs -.->|"uses I/O"| node_sftp_io

click node_linux_app "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Linux/Program.cs"
click node_windows_app "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Windows/Program.cs"
click node_main_view "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Views/MainWindow.axaml.cs"
click node_main_vm "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/ViewModels/MainWindowViewModel.cs"
click node_entry_vm "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/ViewModels/FileSystemEntryViewModel.cs"
click node_search "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/ViewModels/SearchManager.cs"
click node_settings "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/FileSurferSettings.cs"
click node_fs_contract "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/IFileSystem.cs"
click node_entry_model "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/IFileSystemEntry.cs"
click node_local_info "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/FileInformation/LocalFileInfoProvider.cs"
click node_file_ops "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/FileOperations/FileOperations.cs"
click node_clipboard "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/FileOperations/ClipboardManager.cs"
click node_archive "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/FileOperations/LocalArchiveManager.cs"
click node_undo "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/UndoRedoHandler.cs"
click node_local_io_linux "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Linux/Services/FileOperations/LinuxFileIOHandler.cs"
click node_local_io_windows "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Windows/Services/FileOperations/WindowsFileIOHandler.cs"
click node_git "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/VersionControl/LocalGitIntegration.cs"
click node_sftp_fs "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/Sftp/SftpFileSystemFactory.cs"
click node_sftp_io "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/Sftp/SftpFileIoHandler.cs"
click node_sync "https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/Sftp/LocalToSftpSynchronizer.cs"

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_main_view,node_main_vm,node_entry_vm,node_search,node_user toneBlue
class node_settings,node_fs_contract,node_entry_model,node_local_info toneAmber
class node_file_ops,node_clipboard,node_archive,node_undo toneMint
class node_git,node_sftp_fs,node_sftp_io,node_sync toneRose
class node_linux_app,node_windows_app,node_local_io_linux,node_local_io_windows toneIndigo
```

## Components

### Desktop UI

- [Explorer window](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Views/MainWindow.axaml.cs): `src/FileSurfer.Core/Views/MainWindow.axaml.cs`
- [Explorer state](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/ViewModels/MainWindowViewModel.cs): `src/FileSurfer.Core/ViewModels/MainWindowViewModel.cs`
- [Entry presentation](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/ViewModels/FileSystemEntryViewModel.cs): `src/FileSurfer.Core/ViewModels/FileSystemEntryViewModel.cs`
- [Recursive search](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/ViewModels/SearchManager.cs): `src/FileSurfer.Core/ViewModels/SearchManager.cs`

### File browsing

- [User settings](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/FileSurferSettings.cs): `src/FileSurfer.Core/FileSurferSettings.cs`
- [Filesystem abstraction](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/IFileSystem.cs): `src/FileSurfer.Core/Models/IFileSystem.cs`
- [File entries](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/IFileSystemEntry.cs): `src/FileSurfer.Core/Models/IFileSystemEntry.cs`
- [Local metadata](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/FileInformation/LocalFileInfoProvider.cs): `src/FileSurfer.Core/Models/FileInformation/LocalFileInfoProvider.cs`

### File operations

- [File operations](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/FileOperations/FileOperations.cs): `src/FileSurfer.Core/Services/FileOperations/FileOperations.cs`
- [Clipboard paste](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/FileOperations/ClipboardManager.cs): `src/FileSurfer.Core/Services/FileOperations/ClipboardManager.cs`
- [Archive handling](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/FileOperations/LocalArchiveManager.cs): `src/FileSurfer.Core/Services/FileOperations/LocalArchiveManager.cs`
- [Undo and redo](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/UndoRedoHandler.cs): `src/FileSurfer.Core/Models/UndoRedoHandler.cs`

### Remote and integrations

- [Git integration](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/VersionControl/LocalGitIntegration.cs): `src/FileSurfer.Core/Services/VersionControl/LocalGitIntegration.cs`
- [SFTP filesystem](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Models/Sftp/SftpFileSystemFactory.cs): `src/FileSurfer.Core/Models/Sftp/SftpFileSystemFactory.cs`
- [SFTP file I/O](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/Sftp/SftpFileIoHandler.cs): `src/FileSurfer.Core/Services/Sftp/SftpFileIoHandler.cs`
- [Directory sync](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Core/Services/Sftp/LocalToSftpSynchronizer.cs): `src/FileSurfer.Core/Services/Sftp/LocalToSftpSynchronizer.cs`

### Platform adapters

- [Linux app](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Linux/Program.cs): `src/FileSurfer.Linux/Program.cs`
- [Windows app](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Windows/Program.cs): `src/FileSurfer.Windows/Program.cs`
- [Linux file I/O](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Linux/Services/FileOperations/LinuxFileIOHandler.cs): `src/FileSurfer.Linux/Services/FileOperations/LinuxFileIOHandler.cs`
- [Windows file I/O](https://github.com/janecea/filesurfer/blob/master/src/FileSurfer.Windows/Services/FileOperations/WindowsFileIOHandler.cs): `src/FileSurfer.Windows/Services/FileOperations/WindowsFileIOHandler.cs`

### Other components

- **User**

## Connections

- User → Explorer window: uses (evidence: `README.md`)
- Linux app → Explorer state: starts (evidence: `src/FileSurfer.Linux/Program.cs`)
- Windows app → Explorer state: starts (evidence: `src/FileSurfer.Windows/Program.cs`)
- Explorer window → Explorer state: binds to (evidence: `src/FileSurfer.Core/Views/MainWindow.axaml.cs`)
- Explorer state → Recursive search: creates (evidence: `src/FileSurfer.Core/ViewModels/MainWindowViewModel.cs`)
- Recursive search → Filesystem abstraction: enumerates (evidence: `src/FileSurfer.Core/ViewModels/SearchManager.cs`)
- Recursive search → Entry presentation: creates (evidence: `src/FileSurfer.Core/ViewModels/SearchManager.cs`)
- Linux app → Linux file I/O: configures (evidence: `src/FileSurfer.Linux/Program.cs`)
- Windows app → Windows file I/O: configures (evidence: `src/FileSurfer.Windows/Program.cs`)
- Linux app → Git integration: configures (evidence: `src/FileSurfer.Linux/Program.cs`)
- Windows app → Git integration: configures (evidence: `src/FileSurfer.Windows/Program.cs`)
- Linux app → Clipboard paste: configures (evidence: `src/FileSurfer.Linux/Program.cs`)
- Windows app → Clipboard paste: configures (evidence: `src/FileSurfer.Windows/Program.cs`)
- Linux app → Archive handling: configures (evidence: `src/FileSurfer.Linux/Program.cs`)
- Windows app → Archive handling: configures (evidence: `src/FileSurfer.Windows/Program.cs`)
- Windows app → SFTP filesystem: configures (evidence: `src/FileSurfer.Windows/Program.cs`)
- Explorer window → User settings: uses (evidence: `src/FileSurfer.Core/Views/MainWindow.axaml.cs`)
- User → File operations: manages files (evidence: `README.md`)
- User → Clipboard paste: pastes content (evidence: `README.md`)
- User → Undo and redo: reverses actions (evidence: `README.md`)
- User → Git integration: uses Git (evidence: `README.md`)
- User → SFTP filesystem: browses remotely (evidence: `README.md`)
- User → Directory sync: synchronizes folders (evidence: `README.md`)
- File operations → Linux file I/O: uses I/O (evidence: `src/FileSurfer.Linux/Services/FileOperations/LinuxFileIOHandler.cs`)
- File operations → Windows file I/O: uses I/O (evidence: `src/FileSurfer.Windows/Services/FileOperations/WindowsFileIOHandler.cs`)
- SFTP filesystem → SFTP file I/O: uses I/O
