# bethmassi/hybridmauiapp architecture

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

- Interactive diagram: https://gitdiagram.com/bethmassi/hybridmauiapp
- Repository: https://github.com/bethmassi/hybridmauiapp

## Overview

##### Project Type and Purpose
- This is a cross-platform, full-stack demo app built with .NET MAUI 9.
- It showcases the HybridWebView control in two scenarios:
a. A “raw” HTML/JS sample (HybridSamplePage).
b. A React “Todo” app embedded via HybridWebView (ReactTodoApp).
- Runs on Android, iOS, Windows, MacCatalyst, and Tizen.

##### Core Components
A. MAUI Core Layer
- AppShell / Shell navigation
- MauiProgram.cs (service registrations)
- App.xaml / App.xaml.cs
B. UI Pages (XAML + Code-behind)
- MainPage.xaml (+ MainPage.xaml.cs) – hosts HybridSamplePage content
- ReactPage.xaml (+ ReactPage.xaml.cs) – hosts ReactTodoApp content
C. HybridWebView Control
- Embedded in each page
- Loads local assets from Resources/Raw
- Two sub-folders: HybridSamplePage and ReactTodoApp
D. Local Web Content
- HTML/CSS/JS in Resources/Raw/HybridSamplePage
- Built React assets in Resources/Raw/ReactTodoApp (_next folder, etc.)
E. .NET Data Layer
- TodoTask.cs (data model)
- TodoDataStore.cs (in-memory store; JSON serialization)
F. Platform-Specific Projects
- Android, iOS, Windows, MacCatalyst, Tizen subfolders
- Platform entry points and manifests
G. Build/Deployment Artifacts
- Solution file (HybridMauiApp.sln), NuGet.config
- Next.js build pipeline (npm install → npx next build → copy to Resources)

##### Relationships and Data Flows
- User taps UI element in XAML page → HybridWebView sends a message to .NET (invoke .NET method)
- .NET code (MainPage or ReactPage handler) processes call, perhaps via TodoDataStore
- .NET returns data (JSON) back to JS context in WebView
- JS updates HTML UI accordingly

##### Architectural Patterns & Principles
- Shell-based navigation from AppShell
- MVVM-style separation (Views in XAML; View logic in .cs code-behind or view models)
- Hybrid Web architecture: local file system assets + bidirectional message–passing API
- Cross-platform abstraction: one codebase, multiple platform entry points

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% MAUI Core Layer
    subgraph "MAUI Core Layer"
        direction TB
        AppShell["AppShell"]:::dotnet
        MauiProgram["MauiProgram.cs"]:::dotnet
        AppXaml["App.xaml / App.xaml.cs"]:::dotnet
    end

    %% UI Pages
    subgraph "UI Pages"
        direction TB
        MainPage["MainPage.xaml / .cs"]:::dotnet
        ReactPage["ReactPage.xaml / .cs"]:::dotnet
    end

    %% HybridWebView Controls
    subgraph "HybridWebView Control"
        direction TB
        HybridWebViewRaw["Raw HybridWebView"]:::web
        HybridWebViewReact["React HybridWebView"]:::web
    end

    %% Web Content
    subgraph "Local Web Content"
        direction TB
        HybridSampleContent["Resources/Raw/HybridSamplePage"]:::web
        ReactTodoContent["Resources/Raw/ReactTodoApp"]:::web
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        TodoTask["TodoTask.cs"]:::data
        TodoDataStore["TodoDataStore.cs"]:::data
    end

    %% Platforms
    subgraph "Platform-Specific Projects"
        direction TB
        AndroidPlat["Android"]:::platform
        iOSPlat["iOS"]:::platform
        WinPlat["Windows"]:::platform
        MacPlat["MacCatalyst"]:::platform
        TizenPlat["Tizen"]:::platform
    end

    %% Solution & Build
    Solution["HybridMauiApp.sln / NuGet.config"]:::meta

    %% Navigation Flow
    AppShell -->|"Shell Navigation"| MainPage
    AppShell -->|"Shell Navigation"| ReactPage

    MainPage -->|"Hosts"| HybridWebViewRaw
    ReactPage -->|"Hosts"| HybridWebViewReact

    HybridWebViewRaw -->|"Loads"| HybridSampleContent
    HybridWebViewReact -->|"Loads"| ReactTodoContent

    %% Data Flow
    HybridWebViewRaw <-->|"JS ↔ .NET"| MainPage
    HybridWebViewReact <-->|"JS ↔ .NET"| ReactPage
    MainPage -->|"Calls"| TodoDataStore
    ReactPage -->|"Calls"| TodoDataStore
    TodoDataStore -->|"Uses"| TodoTask

    %% Platforms relation
    Solution -->|"Context"| AndroidPlat
    Solution -->|"Context"| iOSPlat
    Solution -->|"Context"| WinPlat
    Solution -->|"Context"| MacPlat
    Solution -->|"Context"| TizenPlat

    %% Click Events
    click AppShell "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/AppShell.xaml"
    click MauiProgram "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/MauiProgram.cs"
    click AppXaml "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/App.xaml"
    click MainPage "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/MainPage.xaml"
    click ReactPage "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/ReactPage.xaml"
    click HybridWebViewRaw "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/Resources/Raw/HybridSamplePage/scripts/HybridWebView.js"
    click HybridWebViewReact "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/Resources/Raw/ReactTodoApp/HybridWebView.js"
    click HybridSampleContent "https://github.com/bethmassi/hybridmauiapp/tree/main/HybridMauiApp/Resources/Raw/HybridSamplePage"
    click ReactTodoContent "https://github.com/bethmassi/hybridmauiapp/tree/main/HybridMauiApp/Resources/Raw/ReactTodoApp"
    click TodoTask "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/TodoTask.cs"
    click TodoDataStore "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp/TodoDataStore.cs"
    click AndroidPlat "https://github.com/bethmassi/hybridmauiapp/tree/main/HybridMauiApp/Platforms/Android"
    click iOSPlat "https://github.com/bethmassi/hybridmauiapp/tree/main/HybridMauiApp/Platforms/iOS"
    click WinPlat "https://github.com/bethmassi/hybridmauiapp/tree/main/HybridMauiApp/Platforms/Windows"
    click MacPlat "https://github.com/bethmassi/hybridmauiapp/tree/main/HybridMauiApp/Platforms/MacCatalyst"
    click TizenPlat "https://github.com/bethmassi/hybridmauiapp/tree/main/HybridMauiApp/Platforms/Tizen"
    click Solution "https://github.com/bethmassi/hybridmauiapp/blob/main/HybridMauiApp.sln"

    %% Styles
    classDef dotnet fill:#daf5d4,stroke:#4CAF50,stroke-width:1px;
    classDef web fill:#d0ebff,stroke:#2196F3,stroke-width:1px;
    classDef data fill:#ffebcc,stroke:#FF9800,stroke-width:1px;
    classDef platform fill:#f0f0f0,stroke:#9E9E9E,stroke-width:1px;
    classDef meta fill:#eeeeee,stroke:#607D8B,stroke-width:1px;
```
