# kaic-eder/avaloniaestudos architecture

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

- Interactive diagram: https://gitdiagram.com/kaic-eder/avaloniaestudos
- Repository: https://github.com/kaic-eder/avaloniaestudos

## Overview

1. This repository is a .NET/Avalonia desktop solution containing four separate sample applications: `AvaloniaEstudos`, `MVVMPattern`, `MusicStore`, and `ToDoApp`. They are not one monolith; each project has its own `Program.cs`, `App.axaml`, views, and viewmodels.

2. The common architectural baseline across all projects is Avalonia UI with XAML views and the MVVM pattern. The typical data flow is: user interaction in a `View` binds to a `ViewModel`, which updates `Model` state or calls a small service, then the UI refreshes through binding.

3. Each app follows the standard Avalonia bootstrap path: `Program.cs` starts the app, `App.axaml` defines application-level resources and startup behavior, and `ViewLocator.cs` supports mapping viewmodels to views for navigation/presentation.

4. `AvaloniaEstudos` is the simplest starter app. It contains a single main window (`Views/MainWindow.axaml`) backed by `ViewModels/MainWindowViewModel.cs`, plus the usual `ViewModelBase`. This looks like a minimal shell for learning Avalonia mechanics.

5. `MVVMPattern` is a focused pattern demo. It adds `SimpleViewModel` alongside `MainWindowViewModel`, suggesting it is meant to show how multiple viewmodels can be structured and swapped into the same window/view infrastructure.

6. `ToDoApp` is a small domain-oriented sample. Its architecture is model-driven: `Models/ToDoItem.cs` represents the data entity, `ViewModels/ToDoItemViewModel.cs` adapts it for the UI, and `MainWindowViewModel` likely coordinates the list and user actions. This is a straightforward model-to-viewmodel-to-view pipeline.

7. `MusicStore` is the richest subsystem and has clearer layering. It separates `Models` (`Album`), `Services` (`AlbumService`), `ViewModels` (`AlbumViewModel`, `MusicStoreViewModel`, `MainWindowViewModel`), and `Views` (`AlbumView`, `MusicStoreView`, `MusicStoreWindow`). This creates a distinct domain/service layer beneath the UI layer.

8. `MusicStore` also includes a `Messages` folder with several message types such as `PurchaseAlbumMessage`, `NotificationMessage`, `CheckAlbumAlreadyExistsMessage`, and `MusicStoreClosedMessage`. That strongly suggests in-process decoupled communication between viewmodels or components, rather than direct tight coupling.

9. The most likely `MusicStore` flow is: user actions in a view trigger a viewmodel, the viewmodel calls `AlbumService` or publishes/consumes messages, and other viewmodels or UI surfaces react to those messages. This is the main architectural boundary in the repo: UI interaction, domain logic, and cross-component coordination are separated.

10. `Assets` and `Assets/Resources` hold application resources such as `Icons.axaml` in `MusicStore`. These are UI-supporting assets rather than core logic, but they matter for understanding that visual resources are centralized at the app level.

11. The `app.manifest` files indicate each desktop app is packaged as its own Windows application. There is no sign of backend APIs, databases, or external services in the file tree; the architecture is entirely client-side desktop UI with local in-memory/domain services.

12. For an architecture diagram, the key boundaries are: solution-level separation between apps, per-app Avalonia bootstrap, MVVM UI boundary, optional service layer (`MusicStore`), and message-based coordination inside the richer sample. The repo is primarily a teaching/experimentation workspace for Avalonia desktop patterns rather than a single integrated product.

Main entry points: [`MusicStore/ViewModels/MusicStoreViewModel.cs`](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewModels/MusicStoreViewModel.cs) (Store VM), [`AvaloniaEstudos/App.axaml`](https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/App.axaml) (App), [`MVVMPattern/App.axaml`](https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/App.axaml) (App), [`MVVMPattern/ViewModels/MainWindowViewModel.cs`](https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/ViewModels/MainWindowViewModel.cs) (Main VM)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace"]
  node_repo["Workspace<br/>solution"]
end

subgraph group_avaloniaestudos["AvaloniaEstudos"]
  node_ae_program["Program<br/>bootstrap<br/>[Program.cs]"]
  node_ae_app["App<br/>[App.axaml]"]
  node_ae_locator["View locator<br/>view mapping<br/>[ViewLocator.cs]"]
  node_ae_vm["Main VM<br/>viewmodel"]
  node_ae_view["Main window<br/>view<br/>[MainWindow.axaml]"]
end

subgraph group_mvvmpattern["MVVMPattern"]
  node_mv_program["Program<br/>bootstrap<br/>[Program.cs]"]
  node_mv_app["App<br/>[App.axaml]"]
  node_mv_locator["View locator<br/>view mapping<br/>[ViewLocator.cs]"]
  node_mv_mainvm["Main VM<br/>viewmodel"]
  node_mv_simplevm["Simple VM<br/>viewmodel<br/>[SimpleViewModel.cs]"]
  node_mv_view["Main window<br/>view<br/>[MainWindow.axaml]"]
end

subgraph group_musicstore["MusicStore"]
  node_ms_program["Program<br/>bootstrap<br/>[Program.cs]"]
  node_ms_app["App<br/>[App.axaml]"]
  node_ms_locator["View locator<br/>view mapping<br/>[ViewLocator.cs]"]
  node_ms_album["Album<br/>model<br/>[Album.cs]"]
  node_ms_service[("Album service<br/>domain service<br/>[AlbumService.cs]")]
  node_ms_albumvm["Album VM<br/>viewmodel<br/>[AlbumViewModel.cs]"]
  node_ms_storevm["Store VM<br/>viewmodel"]
  node_ms_mainvm["Main VM<br/>viewmodel"]
  node_ms_storeview["Store view"]
  node_ms_window["Store window"]
  node_ms_messages{{"Messages<br/>message bus"}}
  node_ms_resources["Resources<br/>ui assets<br/>[Icons.axaml]"]
end

subgraph group_todoapp["ToDoApp"]
  node_td_program["Program<br/>bootstrap<br/>[Program.cs]"]
  node_td_app["App<br/>[App.axaml]"]
  node_td_locator["View locator<br/>view mapping<br/>[ViewLocator.cs]"]
  node_td_item["To-do item<br/>model<br/>[ToDoItem.cs]"]
  node_td_itemvm["Item VM<br/>viewmodel"]
  node_td_mainvm["Main VM<br/>viewmodel"]
  node_td_view["Main window<br/>view<br/>[MainWindow.axaml]"]
end

node_repo -->|"contains"| node_ae_program
node_repo -->|"contains"| node_mv_program
node_repo -->|"contains"| node_ms_program
node_repo -->|"contains"| node_td_program
node_ae_program -->|"starts"| node_ae_app
node_ae_app -->|"uses"| node_ae_locator
node_ae_app -->|"hosts"| node_ae_vm
node_ae_locator -.->|"maps to"| node_ae_view
node_ae_vm -->|"binds"| node_ae_view
node_mv_program -->|"starts"| node_mv_app
node_mv_app -->|"uses"| node_mv_locator
node_mv_app -->|"hosts"| node_mv_mainvm
node_mv_mainvm -.->|"swaps"| node_mv_simplevm
node_mv_locator -.->|"maps to"| node_mv_view
node_mv_mainvm -->|"binds"| node_mv_view
node_ms_program -->|"starts"| node_ms_app
node_ms_app -->|"uses"| node_ms_locator
node_ms_app -->|"hosts"| node_ms_mainvm
node_ms_mainvm -->|"orchestrates"| node_ms_storevm
node_ms_storevm -->|"calls"| node_ms_service
node_ms_service -->|"manages"| node_ms_album
node_ms_albumvm -->|"adapts"| node_ms_album
node_ms_storevm -.->|"publishes/consumes"| node_ms_messages
node_ms_messages -.->|"notifies"| node_ms_albumvm
node_ms_messages -.->|"signals"| node_ms_storeview
node_ms_locator -.->|"maps to"| node_ms_window
node_ms_locator -.->|"maps to"| node_ms_storeview
node_ms_storeview -->|"binds"| node_ms_storevm
node_ms_mainvm -->|"uses"| node_ms_resources
node_td_program -->|"starts"| node_td_app
node_td_app -->|"uses"| node_td_locator
node_td_app -->|"hosts"| node_td_mainvm
node_td_mainvm -->|"contains"| node_td_itemvm
node_td_itemvm -->|"adapts"| node_td_item
node_td_locator -.->|"maps to"| node_td_view
node_td_mainvm -->|"binds"| node_td_view

click node_ae_program "https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/Program.cs"
click node_ae_app "https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/App.axaml"
click node_ae_locator "https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/ViewLocator.cs"
click node_ae_vm "https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/ViewModels/MainWindowViewModel.cs"
click node_ae_view "https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/Views/MainWindow.axaml"
click node_mv_program "https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/Program.cs"
click node_mv_app "https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/App.axaml"
click node_mv_locator "https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/ViewLocator.cs"
click node_mv_mainvm "https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/ViewModels/MainWindowViewModel.cs"
click node_mv_simplevm "https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/ViewModels/SimpleViewModel.cs"
click node_mv_view "https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/Views/MainWindow.axaml"
click node_ms_program "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Program.cs"
click node_ms_app "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/App.axaml"
click node_ms_locator "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewLocator.cs"
click node_ms_album "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Models/Album.cs"
click node_ms_service "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Services/AlbumService.cs"
click node_ms_albumvm "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewModels/AlbumViewModel.cs"
click node_ms_storevm "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewModels/MusicStoreViewModel.cs"
click node_ms_mainvm "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewModels/MainWindowViewModel.cs"
click node_ms_storeview "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Views/MusicStoreView.axaml"
click node_ms_window "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Views/MusicStoreWindow.axaml"
click node_ms_resources "https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Assets/Resources/Icons.axaml"
click node_td_program "https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/Program.cs"
click node_td_app "https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/App.axaml"
click node_td_locator "https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/ViewLocator.cs"
click node_td_item "https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/Models/ToDoItem.cs"
click node_td_itemvm "https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/ViewModels/ToDoItemViewModel.cs"
click node_td_mainvm "https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/ViewModels/MainWindowViewModel.cs"
click node_td_view "https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/Views/MainWindow.axaml"

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_repo toneBlue
class node_ae_program,node_ae_app,node_ae_locator,node_ae_vm,node_ae_view toneAmber
class node_mv_program,node_mv_app,node_mv_locator,node_mv_mainvm,node_mv_simplevm,node_mv_view toneMint
class node_ms_program,node_ms_app,node_ms_locator,node_ms_album,node_ms_service,node_ms_albumvm,node_ms_storevm,node_ms_mainvm,node_ms_storeview,node_ms_window,node_ms_messages,node_ms_resources toneRose
class node_td_program,node_td_app,node_td_locator,node_td_item,node_td_itemvm,node_td_mainvm,node_td_view toneIndigo
```

## Components

### Workspace

Solution-level desktop samples built with Avalonia and MVVM.

- **Workspace**: solution · Repository contains four independent Avalonia desktop apps.

### AvaloniaEstudos

Minimal Avalonia starter app.

- [Program](https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/Program.cs): bootstrap · App entry point. · `AvaloniaEstudos/Program.cs`
- [App](https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/App.axaml): app shell · Application resources and startup wiring. · `AvaloniaEstudos/App.axaml`
- [View locator](https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/ViewLocator.cs): view mapping · Maps viewmodels to views for presentation. · `AvaloniaEstudos/ViewLocator.cs`
- [Main VM](https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/ViewModels/MainWindowViewModel.cs): viewmodel · Main window state and interaction logic. · `AvaloniaEstudos/ViewModels/MainWindowViewModel.cs`
- [Main window](https://github.com/kaic-eder/avaloniaestudos/blob/main/AvaloniaEstudos/Views/MainWindow.axaml): view · Primary UI surface for the starter app. · `AvaloniaEstudos/Views/MainWindow.axaml`

### MVVMPattern

Pattern-focused MVVM demo app.

- [Program](https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/Program.cs): bootstrap · App entry point. · `MVVMPattern/Program.cs`
- [App](https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/App.axaml): app shell · Application resources and startup wiring. · `MVVMPattern/App.axaml`
- [View locator](https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/ViewLocator.cs): view mapping · Maps viewmodels to views for presentation. · `MVVMPattern/ViewLocator.cs`
- [Main VM](https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/ViewModels/MainWindowViewModel.cs): viewmodel · Primary window state. · `MVVMPattern/ViewModels/MainWindowViewModel.cs`
- [Simple VM](https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/ViewModels/SimpleViewModel.cs): viewmodel · Secondary viewmodel used to demonstrate swapping and composition. · `MVVMPattern/ViewModels/SimpleViewModel.cs`
- [Main window](https://github.com/kaic-eder/avaloniaestudos/blob/main/MVVMPattern/Views/MainWindow.axaml): view · Primary UI surface for the pattern demo. · `MVVMPattern/Views/MainWindow.axaml`

### MusicStore

Richest sample with model, service, viewmodel, and message layers.

- [Program](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Program.cs): bootstrap · App entry point. · `MusicStore/Program.cs`
- [App](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/App.axaml): app shell · Application resources and startup wiring. · `MusicStore/App.axaml`
- [View locator](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewLocator.cs): view mapping · Maps viewmodels to views for presentation. · `MusicStore/ViewLocator.cs`
- [Album](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Models/Album.cs): model · Domain entity for album data. · `MusicStore/Models/Album.cs`
- [Album service](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Services/AlbumService.cs): domain service · Business/data operations for albums. · `MusicStore/Services/AlbumService.cs`
- [Album VM](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewModels/AlbumViewModel.cs): viewmodel · Adapts album data for the UI. · `MusicStore/ViewModels/AlbumViewModel.cs`
- [Store VM](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewModels/MusicStoreViewModel.cs): viewmodel · Coordinates store behavior and messaging. · `MusicStore/ViewModels/MusicStoreViewModel.cs`
- [Main VM](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/ViewModels/MainWindowViewModel.cs): viewmodel · Top-level window state for the music store. · `MusicStore/ViewModels/MainWindowViewModel.cs`
- [Store view](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Views/MusicStoreView.axaml): view · Main store interaction surface. · `MusicStore/Views/MusicStoreView.axaml`
- [Store window](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Views/MusicStoreWindow.axaml): window · Outer music store window shell. · `MusicStore/Views/MusicStoreWindow.axaml`
- **Messages**: message bus · In-process coordination messages between components.
- [Resources](https://github.com/kaic-eder/avaloniaestudos/blob/main/MusicStore/Assets/Resources/Icons.axaml): ui assets · Centralized icons and UI resource dictionaries. · `MusicStore/Assets/Resources/Icons.axaml`

### ToDoApp

Small model-driven task sample.

- [Program](https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/Program.cs): bootstrap · App entry point. · `ToDoApp/Program.cs`
- [App](https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/App.axaml): app shell · Application resources and startup wiring. · `ToDoApp/App.axaml`
- [View locator](https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/ViewLocator.cs): view mapping · Maps viewmodels to views for presentation. · `ToDoApp/ViewLocator.cs`
- [To-do item](https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/Models/ToDoItem.cs): model · Task data entity. · `ToDoApp/Models/ToDoItem.cs`
- [Item VM](https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/ViewModels/ToDoItemViewModel.cs): viewmodel · UI adapter for a to-do item. · `ToDoApp/ViewModels/ToDoItemViewModel.cs`
- [Main VM](https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/ViewModels/MainWindowViewModel.cs): viewmodel · Coordinates list and user actions. · `ToDoApp/ViewModels/MainWindowViewModel.cs`
- [Main window](https://github.com/kaic-eder/avaloniaestudos/blob/main/ToDoApp/Views/MainWindow.axaml): view · Primary task list UI. · `ToDoApp/Views/MainWindow.axaml`

## Connections

- Workspace → Program: contains · Workspace includes the AvaloniaEstudos app.
- Workspace → Program: contains · Workspace includes the MVVMPattern app.
- Workspace → Program: contains · Workspace includes the MusicStore app.
- Workspace → Program: contains · Workspace includes the ToDoApp app.
- Program → App: starts · Bootstrap loads application shell.
- App → View locator: uses · App resolves views from viewmodels.
- App → Main VM: hosts · Main window is driven by the main viewmodel.
- View locator → Main window: maps to · View locator binds the main viewmodel to the main view.
- Main VM → Main window: binds · View interactions flow through bindings.
- Program → App: starts · Bootstrap loads application shell.
- App → View locator: uses · App resolves views from viewmodels.
- App → Main VM: hosts · Main window is driven by the main viewmodel.
- Main VM → Simple VM: swaps · Demo demonstrates alternative viewmodel composition.
- View locator → Main window: maps to · View locator binds the viewmodels to the main view.
- Main VM → Main window: binds · UI is updated through MVVM bindings.
- Program → App: starts · Bootstrap loads application shell.
- App → View locator: uses · App resolves views from viewmodels.
- App → Main VM: hosts · Top-level store window state is attached here.
- Main VM → Store VM: orchestrates · Main VM delegates store behavior to the store VM.
- Store VM → Album service: calls · Business operations are handled by the album service.
- Album service → Album: manages · Service operates on album domain objects.
- Album VM → Album: adapts · Album viewmodel wraps domain model data for the UI.
- Store VM → Messages: publishes/consumes · Store coordination is message-driven.
- Messages → Album VM: notifies · Messages decouple album-related interactions.
- Messages → Store view: signals · Views and viewmodels react to shared messages.
- View locator → Store window: maps to · View locator connects window and view surfaces.
- View locator → Store view: maps to · View locator connects store content views.
- Store view → Store VM: binds · Store UI binds to the store viewmodel.
- Main VM → Resources: uses · UI resources support the store shell.
- Program → App: starts · Bootstrap loads application shell.
- App → View locator: uses · App resolves views from viewmodels.
- App → Main VM: hosts · Main window is driven by the main viewmodel.
- Main VM → Item VM: contains · List coordination uses item viewmodels.
- Item VM → To-do item: adapts · Item viewmodel wraps the domain model.
- View locator → Main window: maps to · View locator binds the main viewmodel to the main view.
- Main VM → Main window: binds · Task UI is updated through MVVM bindings.
