# dherrera-software/fileflow-desktop architecture

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

- Interactive diagram: https://gitdiagram.com/dherrera-software/fileflow-desktop
- Repository: https://github.com/dherrera-software/fileflow-desktop

## Overview

FileFlow Desktop is an offline Tauri file converter: users select a source and target, the React interface calls the native Rust engine over Tauri IPC, and the engine dispatches by format category before returning a converted file. The graph preserves the documented seven conversion categories and optional system-tool integrations. Some category internals and command wiring are unsampled; those relationships are shown only where the README or indexed references support them.

Main entry points: [`src-tauri/src/convert/mod.rs`](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/mod.rs) (Category dispatch), [`src/App.tsx`](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/App.tsx) (App shell), [`src-tauri/src/convert/external.rs`](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/external.rs) (Tool detection), [`src/lib/tauri.ts`](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/lib/tauri.ts) (Tauri bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Desktop interface"]
  node_app["App shell<br/>[App.tsx]"]
  node_converter["Conversion UI<br/>[ConversionCard.tsx]"]
  node_format_helpers["Format helpers<br/>[formats.ts]"]
  node_ipc["Tauri bridge<br/>[tauri.ts]"]
  node_catalog_ui["Conversion catalog"]
  node_privacy_ui["Privacy view<br/>[PrivacyView.tsx]"]
  node_faq_ui["FAQ view<br/>[FaqView.tsx]"]
end

subgraph group_engine["Conversion engine"]
  node_commands["Native commands<br/>[lib.rs]"]
  node_dispatch["Category dispatch<br/>[mod.rs]"]
  node_catalog["Format catalog<br/>[formats.rs]"]
end

subgraph group_formats["Format handlers"]
  node_documents["Document conversion<br/>[mod.rs]"]
  node_images["Image conversion<br/>[mod.rs]"]
  node_sheets["Spreadsheet conversion<br/>[mod.rs]"]
  node_presentations["Presentation conversion<br/>[presentations.rs]"]
  node_audio["Audio conversion<br/>[mod.rs]"]
  node_video["Video conversion<br/>[video.rs]"]
  node_archives["Archive conversion<br/>[archives.rs]"]
end

subgraph group_integrations["System integrations"]
  node_external["Tool detection<br/>[external.rs]"]
end

node_user(("User"))
node_system_tools{{"Optional tools"}}

node_user -->|"uses"| node_app
node_app -->|"shows"| node_converter
node_app -->|"shows"| node_catalog_ui
node_app -->|"shows"| node_privacy_ui
node_app -->|"shows"| node_faq_ui
node_converter -->|"uses"| node_format_helpers
node_converter -->|"invokes"| node_ipc
node_app -->|"requests metadata"| node_ipc
node_ipc -->|"calls over IPC"| node_commands
node_commands -->|"delegates conversion"| node_dispatch
node_dispatch -->|"looks up formats"| node_catalog
node_dispatch -->|"dispatches by category"| node_documents
node_dispatch -->|"dispatches by category"| node_images
node_dispatch -->|"dispatches by category"| node_sheets
node_dispatch -->|"dispatches by category"| node_presentations
node_dispatch -->|"dispatches by category"| node_audio
node_dispatch -->|"dispatches by category"| node_video
node_dispatch -->|"dispatches by category"| node_archives
node_audio -->|"uses codecs"| node_external
node_video -->|"uses codecs"| node_external
node_archives -->|"uses tools"| node_external
node_documents -.->|"uses optional tools"| node_external
node_images -.->|"uses optional tools"| node_external
node_external -->|"detects and runs"| node_system_tools
node_catalog_ui -.->|"gets matrix"| node_ipc

click node_app "https://github.com/dherrera-software/fileflow-desktop/blob/main/src/App.tsx"
click node_converter "https://github.com/dherrera-software/fileflow-desktop/blob/main/src/features/converter/ConversionCard.tsx"
click node_format_helpers "https://github.com/dherrera-software/fileflow-desktop/blob/main/src/lib/formats.ts"
click node_ipc "https://github.com/dherrera-software/fileflow-desktop/blob/main/src/lib/tauri.ts"
click node_catalog_ui "https://github.com/dherrera-software/fileflow-desktop/blob/main/src/features/converter/ConversionCatalog.tsx"
click node_privacy_ui "https://github.com/dherrera-software/fileflow-desktop/blob/main/src/features/privacy/PrivacyView.tsx"
click node_faq_ui "https://github.com/dherrera-software/fileflow-desktop/blob/main/src/features/faq/FaqView.tsx"
click node_commands "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/lib.rs"
click node_dispatch "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/mod.rs"
click node_catalog "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/catalog/formats.rs"
click node_documents "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/documents/mod.rs"
click node_images "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/images/mod.rs"
click node_sheets "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/sheets/mod.rs"
click node_presentations "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/presentations.rs"
click node_audio "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/audio/mod.rs"
click node_video "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/video.rs"
click node_archives "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/archives.rs"
click node_external "https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/external.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,node_converter,node_format_helpers,node_ipc,node_catalog_ui,node_privacy_ui,node_faq_ui,node_user toneBlue
class node_commands,node_dispatch,node_catalog toneAmber
class node_documents,node_images,node_sheets,node_presentations,node_audio,node_video,node_archives toneMint
class node_external toneRose
class node_system_tools toneIndigo
```

## Components

### Desktop interface

- [App shell](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/App.tsx): `src/App.tsx`
- [Conversion UI](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/features/converter/ConversionCard.tsx): `src/features/converter/ConversionCard.tsx`
- [Format helpers](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/lib/formats.ts): `src/lib/formats.ts`
- [Tauri bridge](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/lib/tauri.ts): `src/lib/tauri.ts`
- [Conversion catalog](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/features/converter/ConversionCatalog.tsx): `src/features/converter/ConversionCatalog.tsx`
- [Privacy view](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/features/privacy/PrivacyView.tsx): `src/features/privacy/PrivacyView.tsx`
- [FAQ view](https://github.com/dherrera-software/fileflow-desktop/blob/main/src/features/faq/FaqView.tsx): `src/features/faq/FaqView.tsx`

### Conversion engine

- [Native commands](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [Category dispatch](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/mod.rs): `src-tauri/src/convert/mod.rs`
- [Format catalog](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/catalog/formats.rs): `src-tauri/src/convert/catalog/formats.rs`

### Format handlers

- [Document conversion](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/documents/mod.rs): `src-tauri/src/convert/documents/mod.rs`
- [Image conversion](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/images/mod.rs): `src-tauri/src/convert/images/mod.rs`
- [Spreadsheet conversion](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/sheets/mod.rs): `src-tauri/src/convert/sheets/mod.rs`
- [Presentation conversion](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/presentations.rs): `src-tauri/src/convert/presentations.rs`
- [Audio conversion](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/audio/mod.rs): `src-tauri/src/convert/audio/mod.rs`
- [Video conversion](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/video.rs): `src-tauri/src/convert/video.rs`
- [Archive conversion](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/archives.rs): `src-tauri/src/convert/archives.rs`

### System integrations

- [Tool detection](https://github.com/dherrera-software/fileflow-desktop/blob/main/src-tauri/src/convert/external.rs): `src-tauri/src/convert/external.rs`

### Other components

- **User**
- **Optional tools**

## Connections

- User → App shell: uses
- App shell → Conversion UI: shows (evidence: `src/App.tsx`)
- App shell → Conversion catalog: shows (evidence: `src/App.tsx`)
- App shell → Privacy view: shows (evidence: `src/App.tsx`)
- App shell → FAQ view: shows (evidence: `src/App.tsx`)
- Conversion UI → Format helpers: uses (evidence: `src/features/converter/ConversionCard.tsx`)
- Conversion UI → Tauri bridge: invokes (evidence: `src/features/converter/ConversionCard.tsx`)
- App shell → Tauri bridge: requests metadata (evidence: `src/App.tsx`)
- Tauri bridge → Native commands: calls over IPC
- Native commands → Category dispatch: delegates conversion (evidence: `src-tauri/src/lib.rs`)
- Category dispatch → Format catalog: looks up formats (evidence: `src-tauri/src/convert/mod.rs`)
- Category dispatch → Document conversion: dispatches by category (evidence: `src-tauri/src/convert/mod.rs`)
- Category dispatch → Image conversion: dispatches by category (evidence: `src-tauri/src/convert/mod.rs`)
- Category dispatch → Spreadsheet conversion: dispatches by category (evidence: `src-tauri/src/convert/mod.rs`)
- Category dispatch → Presentation conversion: dispatches by category (evidence: `src-tauri/src/convert/mod.rs`)
- Category dispatch → Audio conversion: dispatches by category (evidence: `src-tauri/src/convert/mod.rs`)
- Category dispatch → Video conversion: dispatches by category (evidence: `src-tauri/src/convert/mod.rs`)
- Category dispatch → Archive conversion: dispatches by category (evidence: `src-tauri/src/convert/mod.rs`)
- Audio conversion → Tool detection: uses codecs (evidence: `src-tauri/src/convert/audio/mod.rs`)
- Video conversion → Tool detection: uses codecs (evidence: `src-tauri/src/convert/video.rs`)
- Archive conversion → Tool detection: uses tools (evidence: `src-tauri/src/convert/archives.rs`)
- Document conversion → Tool detection: uses optional tools (evidence: `src-tauri/src/convert/documents/mod.rs`)
- Image conversion → Tool detection: uses optional tools (evidence: `src-tauri/src/convert/images/mod.rs`)
- Tool detection → Optional tools: detects and runs
- Conversion catalog → Tauri bridge: gets matrix
