# prismlibrary/prism architecture

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

- Interactive diagram: https://gitdiagram.com/prismlibrary/prism
- Repository: https://github.com/prismlibrary/prism

## Overview

Prism is a cross-platform XAML application framework for WPF, Avalonia, MAUI, Uno and WinUI. The principal workflow is: an application starts Prism, configures dependency injection and modules, resolves view models and views, then handles user navigation through pages or regions and presents dialogs. Its core layers also provide MVVM commands, observable state, pub/sub events, modular initialization, region composition, page/window navigation, and platform-specific dialog integration. Some relationships are inferred from documented APIs because only selected implementation excerpts were sampled.

Main entry points: [`src/Maui/Prism.Maui/PrismAppBuilder.cs`](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/PrismAppBuilder.cs) (Prism App Builder), [`src/Maui/Prism.Maui/Navigation/Regions/Xaml/RegionManager.cs`](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Xaml/RegionManager.cs) (Region Manager), [`src/Maui/Prism.Maui/Modularity/ModuleManager.cs`](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Modularity/ModuleManager.cs) (Module Manager), [`src/Maui/Prism.Maui/Navigation/PageNavigationService.cs`](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/PageNavigationService.cs) (Page Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application Lifecycle"]
  node_prism_app["Prism Application"]
  node_app_builder["Prism App Builder<br/>[PrismAppBuilder.cs]"]
  node_window_manager["Window Manager"]
end

subgraph group_composition["Composition and Modules"]
  node_container["DI Container"]
  node_module_catalog["Module Catalog<br/>[ModuleCatalog.cs]"]
  node_module_manager["Module Manager<br/>[ModuleManager.cs]"]
  node_module_initializer["Module Initializer"]
end

subgraph group_mvvm["MVVM and Events"]
  node_view_locator["View Model Locator"]
  node_bindable_base["Bindable State<br/>[BindableBase.cs]"]
  node_commands["Delegate Commands<br/>[DelegateCommand.cs]"]
  node_events["Event Aggregator<br/>[EventAggregator.cs]"]
end

subgraph group_navigation["Navigation and Regions"]
  node_navigation_service["Page Navigation"]
  node_region_manager["Region Manager<br/>[RegionManager.cs]"]
  node_region_registry["Region View Registry"]
  node_region_navigation["Region Navigation"]
  node_region_adapters["Region Adapters"]
  node_region_registration["Region Registration"]
end

subgraph group_dialogs["Dialogs and Integrations"]
  node_dialog_service["Dialog Service<br/>[DialogService.cs]"]
  node_dialog_registry["Dialog View Registry"]
  node_page_dialogs["Page Dialog Service"]
  node_navigation_observer["Navigation Observer"]
end

node_user(("Application User"))

node_user -->|"starts"| node_prism_app
node_prism_app -->|"configures"| node_app_builder
node_app_builder -->|"builds"| node_container
node_app_builder -->|"creates windows"| node_window_manager
node_app_builder -->|"starts modules"| node_module_manager
node_module_manager -->|"loads from"| node_module_catalog
node_module_manager -->|"initializes"| node_module_initializer
node_container -->|"resolves"| node_view_locator
node_view_locator -->|"creates state"| node_bindable_base
node_user -->|"invokes"| node_commands
node_user -->|"requests navigation"| node_navigation_service
node_navigation_service -->|"manages windows"| node_window_manager
node_region_manager -->|"registers views"| node_region_registry
node_region_manager -->|"requests navigation"| node_region_navigation
node_region_manager -->|"creates regions"| node_region_adapters
node_region_registration -->|"registers regions"| node_region_manager
node_dialog_service -->|"resolves dialogs"| node_dialog_registry
node_user -->|"opens dialogs"| node_dialog_service
node_user -->|"opens alerts"| node_page_dialogs
node_navigation_service -.->|"publishes navigation"| node_navigation_observer

click node_prism_app "https://github.com/prismlibrary/prism/blob/master/src/Avalonia/Prism.Avalonia/PrismApplicationBase.cs"
click node_app_builder "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/PrismAppBuilder.cs"
click node_window_manager "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/PrismWindowManager.cs"
click node_container "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Ioc/ContainerProvider.cs"
click node_module_catalog "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Modularity/ModuleCatalog.cs"
click node_module_manager "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Modularity/ModuleManager.cs"
click node_module_initializer "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Modularity/ModuleInitializer.cs"
click node_view_locator "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Mvvm/ViewModelLocator.cs"
click node_bindable_base "https://github.com/prismlibrary/prism/blob/master/src/Prism.Core/Mvvm/BindableBase.cs"
click node_commands "https://github.com/prismlibrary/prism/blob/master/src/Prism.Core/Commands/DelegateCommand.cs"
click node_events "https://github.com/prismlibrary/prism/blob/master/src/Prism.Events/EventAggregator.cs"
click node_navigation_service "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/PageNavigationService.cs"
click node_region_manager "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Xaml/RegionManager.cs"
click node_region_registry "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/RegionViewRegistry.cs"
click node_region_navigation "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Navigation/RegionNavigationService.cs"
click node_region_adapters "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Adapters/RegionAdapterMappings.cs"
click node_region_registration "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Behaviors/RegionManagerRegistrationBehavior.cs"
click node_dialog_service "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Dialogs/DialogService.cs"
click node_dialog_registry "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Dialogs/DialogViewRegistry.cs"
click node_page_dialogs "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Services/PageDialogs/PageDialogService.cs"
click node_navigation_observer "https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui.Rx/GlobalNavigationObserver.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_prism_app,node_app_builder,node_window_manager,node_user toneBlue
class node_container,node_module_catalog,node_module_manager,node_module_initializer toneAmber
class node_view_locator,node_bindable_base,node_commands,node_events toneMint
class node_navigation_service,node_region_manager,node_region_registry,node_region_navigation,node_region_adapters,node_region_registration toneRose
class node_dialog_service,node_dialog_registry,node_page_dialogs,node_navigation_observer toneIndigo
```

## Components

### Application Lifecycle

- [Prism Application](https://github.com/prismlibrary/prism/blob/master/src/Avalonia/Prism.Avalonia/PrismApplicationBase.cs): `src/Avalonia/Prism.Avalonia/PrismApplicationBase.cs`
- [Prism App Builder](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/PrismAppBuilder.cs): `src/Maui/Prism.Maui/PrismAppBuilder.cs`
- [Window Manager](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/PrismWindowManager.cs): `src/Maui/Prism.Maui/Navigation/PrismWindowManager.cs`

### Composition and Modules

- [DI Container](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Ioc/ContainerProvider.cs): `src/Maui/Prism.Maui/Ioc/ContainerProvider.cs`
- [Module Catalog](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Modularity/ModuleCatalog.cs): `src/Maui/Prism.Maui/Modularity/ModuleCatalog.cs`
- [Module Manager](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Modularity/ModuleManager.cs): `src/Maui/Prism.Maui/Modularity/ModuleManager.cs`
- [Module Initializer](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Modularity/ModuleInitializer.cs): `src/Maui/Prism.Maui/Modularity/ModuleInitializer.cs`

### MVVM and Events

- [View Model Locator](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Mvvm/ViewModelLocator.cs): `src/Maui/Prism.Maui/Mvvm/ViewModelLocator.cs`
- [Bindable State](https://github.com/prismlibrary/prism/blob/master/src/Prism.Core/Mvvm/BindableBase.cs): `src/Prism.Core/Mvvm/BindableBase.cs`
- [Delegate Commands](https://github.com/prismlibrary/prism/blob/master/src/Prism.Core/Commands/DelegateCommand.cs): `src/Prism.Core/Commands/DelegateCommand.cs`
- [Event Aggregator](https://github.com/prismlibrary/prism/blob/master/src/Prism.Events/EventAggregator.cs): `src/Prism.Events/EventAggregator.cs`

### Navigation and Regions

- [Page Navigation](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/PageNavigationService.cs): `src/Maui/Prism.Maui/Navigation/PageNavigationService.cs`
- [Region Manager](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Xaml/RegionManager.cs): `src/Maui/Prism.Maui/Navigation/Regions/Xaml/RegionManager.cs`
- [Region View Registry](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/RegionViewRegistry.cs): `src/Maui/Prism.Maui/Navigation/Regions/RegionViewRegistry.cs`
- [Region Navigation](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Navigation/RegionNavigationService.cs): `src/Maui/Prism.Maui/Navigation/Regions/Navigation/RegionNavigationService.cs`
- [Region Adapters](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Adapters/RegionAdapterMappings.cs): `src/Maui/Prism.Maui/Navigation/Regions/Adapters/RegionAdapterMappings.cs`
- [Region Registration](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Navigation/Regions/Behaviors/RegionManagerRegistrationBehavior.cs): `src/Maui/Prism.Maui/Navigation/Regions/Behaviors/RegionManagerRegistrationBehavior.cs`

### Dialogs and Integrations

- [Dialog Service](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Dialogs/DialogService.cs): `src/Maui/Prism.Maui/Dialogs/DialogService.cs`
- [Dialog View Registry](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Dialogs/DialogViewRegistry.cs): `src/Maui/Prism.Maui/Dialogs/DialogViewRegistry.cs`
- [Page Dialog Service](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui/Services/PageDialogs/PageDialogService.cs): `src/Maui/Prism.Maui/Services/PageDialogs/PageDialogService.cs`
- [Navigation Observer](https://github.com/prismlibrary/prism/blob/master/src/Maui/Prism.Maui.Rx/GlobalNavigationObserver.cs): `src/Maui/Prism.Maui.Rx/GlobalNavigationObserver.cs`

### Other components

- **Application User**

## Connections

- Application User → Prism Application: starts
- Prism Application → Prism App Builder: configures
- Prism App Builder → DI Container: builds
- Prism App Builder → Window Manager: creates windows
- Prism App Builder → Module Manager: starts modules
- Module Manager → Module Catalog: loads from
- Module Manager → Module Initializer: initializes
- DI Container → View Model Locator: resolves
- View Model Locator → Bindable State: creates state
- Application User → Delegate Commands: invokes
- Application User → Page Navigation: requests navigation
- Page Navigation → Window Manager: manages windows
- Region Manager → Region View Registry: registers views
- Region Manager → Region Navigation: requests navigation
- Region Manager → Region Adapters: creates regions
- Region Registration → Region Manager: registers regions
- Dialog Service → Dialog View Registry: resolves dialogs
- Application User → Dialog Service: opens dialogs
- Application User → Page Dialog Service: opens alerts
- Page Navigation → Navigation Observer: publishes navigation
