# exfabian/backmyappdata architecture

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

- Interactive diagram: https://gitdiagram.com/exfabian/backmyappdata
- Repository: https://github.com/exfabian/backmyappdata

## Overview

BackMyAppData is a Windows desktop utility for selecting Local, Roaming, or LocalLow AppData folders, backing selected data up to ZIP, and restoring data from ZIP. The main form handles browsing, selection, and operation setup; a progress form runs backup or restore work and reports status. Utilities handle filesystem copying and temporary-folder cleanup. The excerpts show these paths, but do not expose every worker detail, so the diagram focuses on documented capabilities and directly evidenced calls.

Main entry points: [`AppDataBackuper/src/Form1.cs`](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Form1.cs) (Main window), [`AppDataBackuper/src/ProgressForm.cs`](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/ProgressForm.cs) (Backup operation), [`AppDataBackuper/src/Utils.cs`](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Utils.cs) (Copy utilities), [`AppDataBackuper/src/AboutBox1.cs`](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/AboutBox1.cs) (About dialog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_main["Main window<br/>[Form1.cs]"]
  node_about["About dialog<br/>[AboutBox1.cs]"]
  node_progress["Progress window<br/>[ProgressForm.cs]"]
end

subgraph group_operations["Backup and restore"]
  node_backup["Backup operation<br/>[ProgressForm.cs]"]
  node_restore["Restore operation<br/>[ProgressForm.cs]"]
  node_selection["Folder selection<br/>[Form1.cs]"]
  node_validation["Archive validation<br/>[Form1.cs]"]
end

subgraph group_filesystem["Filesystem handling"]
  node_copy["Copy utilities<br/>[Utils.cs]"]
  node_temp["Temporary-folder cleanup<br/>[Utils.cs]"]
end

node_user(("User"))
node_appdata[("AppData folders")]
node_archive["ZIP backup"]

node_user -->|"uses"| node_main
node_main -->|"browses folders"| node_selection
node_main -->|"lists folders"| node_appdata
node_main -->|"opens"| node_about
node_main -->|"checks archive"| node_validation
node_main -->|"starts operation"| node_progress
node_progress -->|"dispatches backup"| node_backup
node_progress -->|"dispatches restore"| node_restore
node_backup -->|"copies folders"| node_copy
node_backup -->|"creates ZIP"| node_archive
node_copy -->|"reads folders"| node_appdata
node_restore -->|"extracts ZIP"| node_archive
node_restore -->|"copies folders"| node_copy
node_copy -->|"writes folders"| node_appdata
node_backup -->|"cleans staging"| node_temp
node_restore -->|"cleans staging"| node_temp

click node_main "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Form1.cs"
click node_about "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/AboutBox1.cs"
click node_progress "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/ProgressForm.cs"
click node_backup "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/ProgressForm.cs"
click node_restore "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/ProgressForm.cs"
click node_selection "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Form1.cs"
click node_validation "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Form1.cs"
click node_copy "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Utils.cs"
click node_temp "https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Utils.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,node_about,node_progress,node_user toneBlue
class node_backup,node_restore,node_selection,node_validation,node_appdata toneAmber
class node_copy,node_temp toneMint
class node_archive toneIndigo
```

## Components

### Desktop interface

- [Main window](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Form1.cs): `AppDataBackuper/src/Form1.cs`
- [About dialog](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/AboutBox1.cs): `AppDataBackuper/src/AboutBox1.cs`
- [Progress window](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/ProgressForm.cs): `AppDataBackuper/src/ProgressForm.cs`

### Backup and restore

- [Backup operation](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/ProgressForm.cs): `AppDataBackuper/src/ProgressForm.cs`
- [Restore operation](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/ProgressForm.cs): `AppDataBackuper/src/ProgressForm.cs`
- [Folder selection](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Form1.cs): `AppDataBackuper/src/Form1.cs`
- [Archive validation](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Form1.cs): `AppDataBackuper/src/Form1.cs`

### Filesystem handling

- [Copy utilities](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Utils.cs): `AppDataBackuper/src/Utils.cs`
- [Temporary-folder cleanup](https://github.com/exfabian/backmyappdata/blob/master/AppDataBackuper/src/Utils.cs): `AppDataBackuper/src/Utils.cs`

### Other components

- **User**
- **AppData folders**
- **ZIP backup**

## Connections

- User → Main window: uses (evidence: `README.md`)
- Main window → Folder selection: browses folders (evidence: `AppDataBackuper/src/Form1.cs`)
- Main window → AppData folders: lists folders (evidence: `AppDataBackuper/src/Form1.cs`)
- Main window → About dialog: opens (evidence: `AppDataBackuper/src/Form1.cs`)
- Main window → Archive validation: checks archive (evidence: `AppDataBackuper/src/Form1.cs`)
- Main window → Progress window: starts operation (evidence: `AppDataBackuper/src/Form1.cs`)
- Progress window → Backup operation: dispatches backup (evidence: `AppDataBackuper/src/ProgressForm.cs`)
- Progress window → Restore operation: dispatches restore (evidence: `AppDataBackuper/src/ProgressForm.cs`)
- Backup operation → Copy utilities: copies folders (evidence: `AppDataBackuper/src/ProgressForm.cs`)
- Backup operation → ZIP backup: creates ZIP (evidence: `AppDataBackuper/src/ProgressForm.cs`)
- Copy utilities → AppData folders: reads folders (evidence: `AppDataBackuper/src/Utils.cs`)
- Restore operation → ZIP backup: extracts ZIP (evidence: `AppDataBackuper/src/ProgressForm.cs`)
- Restore operation → Copy utilities: copies folders (evidence: `AppDataBackuper/src/ProgressForm.cs`)
- Copy utilities → AppData folders: writes folders (evidence: `AppDataBackuper/src/Utils.cs`)
- Backup operation → Temporary-folder cleanup: cleans staging (evidence: `AppDataBackuper/src/ProgressForm.cs`)
- Restore operation → Temporary-folder cleanup: cleans staging (evidence: `AppDataBackuper/src/ProgressForm.cs`)
