# john-ds/express-apps architecture

> Architecture diagram of the GitHub repository john-ds/express-apps, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/john-ds/express-apps
- Repository: https://github.com/john-ds/express-apps

## Overview

##### Project type and purpose
- This is a desktop-only suite of four WPF (Windows Presentation Foundation) applications plus a shared control library:
- Type Express (rich text editor)
- Present Express (slideshow maker)
- Font Express (font organiser)
- Quota Express (storage analysis)
- ExpressControls (custom WPF controls, styles, themes, resources)

##### File structure
- Top-level solution (.sln) that groups five projects.
- “ExpressControls” is a class library containing reusable XAML controls, themes, resources, sounds, etc.
- Four application projects each include:
- App.xaml / App.xaml.cs (application bootstrap)
- MainWindow.xaml/ .cs (UI entry point)
- Options/Settings (Settings.settings + user preferences)
- All use local file system for storing user data and configuration.

##### README
- Confirms the suite purpose: a collection of quality WPF apps, each optimised for a specific task.
- No server or cloud back-end—desktop-only, with occasional “integration” points (Dropbox, ffmpeg calls).

a. Main components
- User Workstation (Windows)
- Four WPF Applications (TypeExpress, PresentExpress, FontExpress, QuotaExpress)
- Shared Control Library (ExpressControls.dll)
- Local Data Stores (app settings, user files, fonts folder, export folder)
- External Tools & Services
- ffmpeg suite (video encoding/decoding)
- FontReg.exe (font registration)
- Dropbox integration pages (dropbox-index.html)
b. Relationships & interactions
- Each WPF app depends on ExpressControls.
- UI Layer (XAML + code-behind or MVVM ViewModels) calls into Controls Library for custom widgets.
- Business Logic in each app reads/writes local storage (settings, documents, fonts, media).
- When multimedia tasks arise (slideshow export, font install), apps invoke external executables (ffmpeg, FontReg).
- Dropbox integration is exposed via embedded browser control pointing to local HTML pages.
c. Architectural patterns & design principles
- MVVM (Model-View-ViewModel) for each WPF app
- Layered separation:
- Presentation (Views, custom controls)
- ViewModels (application logic, command bindings)
- Models (file-based data structures, exportable classes)
- Reusability: ExpressControls library isolates all UI components, styles, themes.
- Convention-based configuration (Settings.settings, App.config).
d. Key technologies
- .NET Framework WPF, XAML, C#
- Third-party tools: ffmpeg suite, FontReg
- Local file I/O, Settings API, Embedded resources (XAML resource dictionaries, sound files)

##### Final advice
- Be exhaustive: include all projects, all major resource folders, all external tool interactions.
- Special integration (Dropbox HTML pages, multimedia pipeline).
- MVVM triad within each app if deeper detail is needed.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Applications and Shared Library
    subgraph "Desktop WPF Suite"
        direction TB
        TypeExpressApp["Type Express App"]:::app
        PresentExpressApp["Present Express App"]:::app
        FontExpressApp["Font Express App"]:::app
        QuotaExpressApp["Quota Express App"]:::app
        ExpressControlsLib["ExpressControls Library"]:::lib
    end

    %% Dependencies
    TypeExpressApp -->|"References"| ExpressControlsLib
    PresentExpressApp -->|"References"| ExpressControlsLib
    FontExpressApp -->|"References"| ExpressControlsLib
    QuotaExpressApp -->|"References"| ExpressControlsLib

    %% Local Data Store
    LocalData["Local Settings & Data"]:::data
    TypeExpressApp ---|"read/write"| LocalData
    PresentExpressApp ---|"read/write"| LocalData
    FontExpressApp ---|"read/write"| LocalData
    QuotaExpressApp ---|"read/write"| LocalData

    %% External Tools & Services
    subgraph "External Tools & Services"
        direction TB
        FFmpeg["ffmpeg.exe, ffplay.exe, ffprobe.exe"]:::ext
        FontReg["FontReg.exe"]:::ext
        DropboxHTML["Dropbox Integration (HTML)"]:::ext
    end
    TypeExpressApp -.->|"invoke"| DropboxHTML
    TypeExpressApp -.->|"invoke"| FFmpeg
    TypeExpressApp -.->|"invoke"| FontReg

    PresentExpressApp -.->|"invoke"| FFmpeg
    PresentExpressApp -.->|"invoke"| DropboxHTML

    FontExpressApp -.->|"invoke"| FontReg
    FontExpressApp -.->|"invoke"| DropboxHTML

    QuotaExpressApp -.->|"invoke"| DropboxHTML

    %% Click Events for ExpressControls
    click ExpressControlsLib "https://github.com/john-ds/express-apps/tree/master/ExpressControls/"
    click ExpressControlsLib "https://github.com/john-ds/express-apps/blob/master/ExpressControls/ExpressControls.csproj"
    click ExpressStyles "https://github.com/john-ds/express-apps/blob/master/ExpressControls/ExpressStyles.xaml"
    click GenericTheme "https://github.com/john-ds/express-apps/blob/master/ExpressControls/Themes/Generic.xaml"
    click SoundError "https://github.com/john-ds/express-apps/blob/master/ExpressControls/sounds/error.wav"
    click SoundExclamation "https://github.com/john-ds/express-apps/blob/master/ExpressControls/sounds/exclamation.wav"
    click SoundInfo "https://github.com/john-ds/express-apps/blob/master/ExpressControls/sounds/information.wav"

    %% Click Events for Type Express
    click TypeExpressApp "https://github.com/john-ds/express-apps/tree/master/Type Express/"
    click TypeExpressApp "https://github.com/john-ds/express-apps/blob/master/Type Express/Type Express.csproj"
    click AppXamlTE "https://github.com/john-ds/express-apps/blob/master/Type Express/App.xaml"
    click AppCsTE "https://github.com/john-ds/express-apps/blob/master/Type Express/App.xaml.cs"
    click MainXamlTE "https://github.com/john-ds/express-apps/blob/master/Type Express/MainWindow.xaml"
    click MainCsTE "https://github.com/john-ds/express-apps/blob/master/Type Express/MainWindow.xaml.cs"
    click OptionsTE "https://github.com/john-ds/express-apps/blob/master/Type Express/Options.xaml"
    click OptionsCsTE "https://github.com/john-ds/express-apps/blob/master/Type Express/Options.xaml.cs"
    click SettingsTE "https://github.com/john-ds/express-apps/blob/master/Type Express/Properties/Settings.settings"
    click DropboxHTMLTE "https://github.com/john-ds/express-apps/blob/master/Type Express/dropbox-index.html"
    click FontsDirTE "https://github.com/john-ds/express-apps/tree/master/Type Express/fonts/"

    %% Click Events for Present Express
    click PresentExpressApp "https://github.com/john-ds/express-apps/tree/master/Present Express/"
    click PresentExpressApp "https://github.com/john-ds/express-apps/blob/master/Present Express/Present Express.csproj"
    click AppXamlPE "https://github.com/john-ds/express-apps/blob/master/Present Express/App.xaml"
    click AppCsPE "https://github.com/john-ds/express-apps/blob/master/Present Express/App.xaml.cs"
    click MainXamlPE "https://github.com/john-ds/express-apps/blob/master/Present Express/MainWindow.xaml"
    click MainCsPE "https://github.com/john-ds/express-apps/blob/master/Present Express/MainWindow.xaml.cs"
    click OptionsPE "https://github.com/john-ds/express-apps/blob/master/Present Express/Options.xaml"
    click OptionsCsPE "https://github.com/john-ds/express-apps/blob/master/Present Express/Options.xaml.cs"
    click SettingsPE "https://github.com/john-ds/express-apps/blob/master/Present Express/Properties/Settings.settings"
    click DropboxHTMLPE "https://github.com/john-ds/express-apps/blob/master/Present Express/dropbox-index.html"
    click ExportIndexPE "https://github.com/john-ds/express-apps/blob/master/Present Express/export-index.html"
    click FFmpegExe "https://github.com/john-ds/express-apps/blob/master/Present Express/ffmpeg/ffmpeg.exe"
    click FFplayExe "https://github.com/john-ds/express-apps/blob/master/Present Express/ffmpeg/ffplay.exe"
    click FFprobeExe "https://github.com/john-ds/express-apps/blob/master/Present Express/ffmpeg/ffprobe.exe"
    click FiltersDirPE "https://github.com/john-ds/express-apps/tree/master/Present Express/filters/"
    click FontsDirPE "https://github.com/john-ds/express-apps/tree/master/Present Express/fonts/"

    %% Click Events for Font Express
    click FontExpressApp "https://github.com/john-ds/express-apps/tree/master/Font Express/"
    click FontExpressApp "https://github.com/john-ds/express-apps/blob/master/Font Express/Font Express.csproj"
    click AppXamlFE "https://github.com/john-ds/express-apps/blob/master/Font Express/App.xaml"
    click AppCsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/App.xaml.cs"
    click MainXamlFE "https://github.com/john-ds/express-apps/blob/master/Font Express/MainWindow.xaml"
    click MainCsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/MainWindow.xaml.cs"
    click OptionsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/Options.xaml"
    click OptionsCsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/Options.xaml.cs"
    click SettingsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/Properties/Settings.settings"
    click AddEditCatFE "https://github.com/john-ds/express-apps/blob/master/Font Express/AddEditCategory.xaml"
    click AddEditCatCsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/AddEditCategory.xaml.cs"
    click CompareFontsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/CompareFonts.xaml"
    click CompareFontsCsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/CompareFonts.xaml.cs"
    click DownloadFontsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/DownloadFonts.xaml"
    click DownloadFontsCsFE "https://github.com/john-ds/express-apps/blob/master/Font Express/DownloadFonts.xaml.cs"
    click FontRegFE "https://github.com/john-ds/express-apps/blob/master/Font Express/fontreg/FontReg.exe"
    click FontsDirFE "https://github.com/john-ds/express-apps/tree/master/Font Express/fonts/"

    %% Click Events for Quota Express
    click QuotaExpressApp "https://github.com/john-ds/express-apps/tree/master/Quota Express/"
    click QuotaExpressApp "https://github.com/john-ds/express-apps/blob/master/Quota Express/Quota Express.csproj"
    click AppXamlQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/App.xaml"
    click AppCsQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/App.xaml.cs"
    click MainXamlQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/MainWindow.xaml"
    click MainCsQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/MainWindow.xaml.cs"
    click OptionsQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/Options.xaml"
    click OptionsCsQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/Options.xaml.cs"
    click SettingsQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/Properties/Settings.settings"
    click CircleProgQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/CircleProgressBar.cs"
    click ColorIconsQE "https://github.com/john-ds/express-apps/blob/master/Quota Express/ColorIcons.xaml"
    click FontsDirQE "https://github.com/john-ds/express-apps/tree/master/Quota Express/fonts/"

    %% Styles
    classDef app fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef lib fill:#90EE90,stroke:#333,stroke-width:1px
    classDef data fill:#D3D3D3,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
    classDef ext fill:#FFA500,stroke:#333,stroke-width:1px,stroke-dasharray: 2 2
```
