# izumipl/avalonia-fluent-ui architecture

> Architecture diagram of the GitHub repository izumipl/avalonia-fluent-ui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/izumipl/avalonia-fluent-ui
- Repository: https://github.com/izumipl/avalonia-fluent-ui

## Overview

Avalonia-Fluent-UI is a Fluent-style control library for Avalonia applications. An application uses its controls and theme to present interactive UI; the repository also supplies navigation, dialogs, notifications, reusable collection views, and a virtualized repeater with layouts and transitions. The README establishes the library’s purpose and intended application use, while the source index and excerpts show some internal repeater and InfoBar relationships. Other feature areas are represented from the tree; their internal wiring is not inferred.

Main entry points: [`src/AvaloniaFluentUI/FluentControls/Repeater/ItemsRepeater.cs`](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/ItemsRepeater.cs) (Items repeater), [`src/AvaloniaFluentUI/FluentControls`](https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/FluentControls) (Fluent controls), [`src/AvaloniaFluentUI/FluentControls/NavigationView/NavigationView.cs`](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/NavigationView/NavigationView.cs) (Navigation view), [`src/AvaloniaFluentUI/FluentControls/Repeater/Layouts`](https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/FluentControls/Repeater/Layouts) (Layout system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Fluent UI"]
  node_controls["Fluent controls"]
  node_navigation["Navigation view<br/>[NavigationView.cs]"]
  node_tabs["Tab view<br/>[TabView.cs]"]
  node_icons["Icon sources<br/>[IconSource.cs]"]
end

subgraph group_collections["Collections And Layout"]
  node_repeater["Items repeater<br/>[ItemsRepeater.cs]"]
  node_viewmanager["View manager<br/>[ViewManager.cs]"]
  node_viewport["Viewport manager<br/>[ViewportManager.cs]"]
  node_layout["Layout system"]
  node_virtualcontext["Virtual layout context"]
  node_transitions["Item transitions"]
  node_collectionviews["Collection views"]
end

subgraph group_feedback["Dialogs And Feedback"]
  node_dialogs["Dialogs"]
  node_infobar["InfoBar controls<br/>[InfoBarBase.cs]"]
  node_infomanager["InfoBar managers"]
end

subgraph group_platform["Theme And Platform"]
  node_theme["Fluent theme"]
  node_settings["UI settings<br/>[UISettings.cs]"]
  node_interop["Windows interop<br/>[Win32Interop.cs]"]
end

node_app(("Avalonia app"))

node_app -->|"uses UI"| node_controls
node_controls -.->|"includes"| node_repeater
node_navigation -->|"uses"| node_repeater
node_repeater -->|"manages elements"| node_viewmanager
node_repeater -->|"prepares elements"| node_transitions
node_repeater -.->|"coordinates viewport"| node_viewport
node_layout -->|"adapts context"| node_virtualcontext
node_settings -->|"reads platform"| node_interop
node_infomanager -->|"hosts bars"| node_infobar

click node_controls "https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/FluentControls"
click node_navigation "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/NavigationView/NavigationView.cs"
click node_tabs "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/TabView/TabView.cs"
click node_icons "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/IconElement/IconSource.cs"
click node_repeater "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/ItemsRepeater.cs"
click node_viewmanager "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/ViewManager.cs"
click node_viewport "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/ViewportManager.cs"
click node_layout "https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/FluentControls/Repeater/Layouts"
click node_virtualcontext "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/Layouts/VirtualizingLayoutContext.cs"
click node_transitions "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/Transitions/TransitionManager.cs"
click node_collectionviews "https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/Data/CollectionView"
click node_dialogs "https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/FluentControls/Dialogs"
click node_infobar "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/InfoBar/InfoBarBase.cs"
click node_infomanager "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/InfoBar/Managers/InfoBarManagerBase.cs"
click node_theme "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControlStyles/Core/AvaloniaFluentTheme.axaml.cs"
click node_settings "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/Core/UISettings.cs"
click node_interop "https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Interop/Win32Interop.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_controls,node_navigation,node_tabs,node_icons toneBlue
class node_repeater,node_viewmanager,node_viewport,node_layout,node_virtualcontext,node_transitions,node_collectionviews toneAmber
class node_dialogs,node_infobar,node_infomanager toneMint
class node_theme,node_settings,node_interop toneRose
class node_app toneIndigo
```

## Components

### Fluent UI

- [Fluent controls](https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/FluentControls): `src/AvaloniaFluentUI/FluentControls`
- [Navigation view](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/NavigationView/NavigationView.cs): `src/AvaloniaFluentUI/FluentControls/NavigationView/NavigationView.cs`
- [Tab view](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/TabView/TabView.cs): `src/AvaloniaFluentUI/FluentControls/TabView/TabView.cs`
- [Icon sources](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/IconElement/IconSource.cs): `src/AvaloniaFluentUI/FluentControls/IconElement/IconSource.cs`

### Collections And Layout

- [Items repeater](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/ItemsRepeater.cs): `src/AvaloniaFluentUI/FluentControls/Repeater/ItemsRepeater.cs`
- [View manager](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/ViewManager.cs): `src/AvaloniaFluentUI/FluentControls/Repeater/ViewManager.cs`
- [Viewport manager](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/ViewportManager.cs): `src/AvaloniaFluentUI/FluentControls/Repeater/ViewportManager.cs`
- [Layout system](https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/FluentControls/Repeater/Layouts): `src/AvaloniaFluentUI/FluentControls/Repeater/Layouts`
- [Virtual layout context](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/Layouts/VirtualizingLayoutContext.cs): `src/AvaloniaFluentUI/FluentControls/Repeater/Layouts/VirtualizingLayoutContext.cs`
- [Item transitions](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Repeater/Transitions/TransitionManager.cs): `src/AvaloniaFluentUI/FluentControls/Repeater/Transitions/TransitionManager.cs`
- [Collection views](https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/Data/CollectionView): `src/AvaloniaFluentUI/Data/CollectionView`

### Dialogs And Feedback

- [Dialogs](https://github.com/izumipl/avalonia-fluent-ui/tree/master/src/AvaloniaFluentUI/FluentControls/Dialogs): `src/AvaloniaFluentUI/FluentControls/Dialogs`
- [InfoBar controls](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/InfoBar/InfoBarBase.cs): `src/AvaloniaFluentUI/FluentControls/InfoBar/InfoBarBase.cs`
- [InfoBar managers](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/InfoBar/Managers/InfoBarManagerBase.cs): `src/AvaloniaFluentUI/FluentControls/InfoBar/Managers/InfoBarManagerBase.cs`

### Theme And Platform

- [Fluent theme](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControlStyles/Core/AvaloniaFluentTheme.axaml.cs): `src/AvaloniaFluentUI/FluentControlStyles/Core/AvaloniaFluentTheme.axaml.cs`
- [UI settings](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/Core/UISettings.cs): `src/AvaloniaFluentUI/Core/UISettings.cs`
- [Windows interop](https://github.com/izumipl/avalonia-fluent-ui/blob/master/src/AvaloniaFluentUI/FluentControls/Interop/Win32Interop.cs): `src/AvaloniaFluentUI/FluentControls/Interop/Win32Interop.cs`

### Other components

- **Avalonia app**

## Connections

- Avalonia app → Fluent controls: uses UI
- Fluent controls → Items repeater: includes (evidence: `src/AvaloniaFluentUI/FluentControls/Repeater/ViewManager.cs`)
- Navigation view → Items repeater: uses (evidence: `src/AvaloniaFluentUI/FluentControls/NavigationView/NavigationView.cs`)
- Items repeater → View manager: manages elements (evidence: `src/AvaloniaFluentUI/FluentControls/Repeater/ViewManager.cs`)
- Items repeater → Item transitions: prepares elements (evidence: `src/AvaloniaFluentUI/FluentControls/Repeater/ViewManager.cs`)
- Items repeater → Viewport manager: coordinates viewport (evidence: `src/AvaloniaFluentUI/FluentControls/Repeater/ItemsRepeater.cs`)
- Layout system → Virtual layout context: adapts context (evidence: `src/AvaloniaFluentUI/FluentControls/Repeater/Layouts/Layout.cs`)
- UI settings → Windows interop: reads platform (evidence: `src/AvaloniaFluentUI/Core/UISettings.cs`)
- InfoBar managers → InfoBar controls: hosts bars (evidence: `src/AvaloniaFluentUI/FluentControls/InfoBar/Managers/InfoBarManagerBase.cs`)
