# microsoftedge/webview2samples architecture

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

- Interactive diagram: https://gitdiagram.com/microsoftedge/webview2samples
- Repository: https://github.com/microsoftedge/webview2samples

## Overview

WebView2 Samples is a collection of tutorial projects and runnable browser/API examples, not a single end-user product. The principal workflow is a developer launching a sample, exercising a WebView2 capability through its host UI, and observing the result in the browser or host. The tree also includes framework-specific browser samples and composition/extension examples. The README mentions deployment samples, but none appear in the supplied tree, so that branch is not mapped. Several sample internals were not excerpted; uncertain wiring is omitted.

Main entry points: [`SampleApps/WebView2WindowsFormsBrowser/BrowserForm.cs`](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WindowsFormsBrowser/BrowserForm.cs) (WinForms Browser), [`SampleApps/WebView2APISample/AppWindow.h`](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/AppWindow.h) (App Window), [`SampleApps/WebView2APISample/ScenarioServiceWorkerManager.cpp`](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/ScenarioServiceWorkerManager.cpp) (Service Workers), [`SampleApps/WebView2APISample/ScenarioSharedWorkerManager.cpp`](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/ScenarioSharedWorkerManager.cpp) (Shared Workers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tutorials["Getting Started"]
  node_winforms_tutorial["WinForms Tutorial<br/>[Form1.cs]"]
  node_win32_tutorial["Win32 Tutorial<br/>[HelloWebView.cpp]"]
  node_wpf_tutorial["WPF Tutorial<br/>[MainWindow.xaml.cs]"]
  node_winui_tutorials["WinUI Tutorials"]
end

subgraph group_api["Native API Sample"]
  node_api_app["API Sample App<br/>[App.cpp]"]
  node_api_window["App Window<br/>[AppWindow.h]"]
  node_component_framework["Component Framework<br/>[ComponentBase.h]"]
  node_service_workers["Service Workers"]
  node_shared_workers["Shared Workers"]
end

subgraph group_browsers["Browser Samples"]
  node_winforms_browser["WinForms Browser<br/>[BrowserForm.cs]"]
  node_browser_dialogs["Browser Dialogs"]
  node_event_monitor["Event Monitor<br/>[EventMonitor.cs]"]
  node_wpf_browser["WPF Browser<br/>[MainWindow.xaml.cs]"]
  node_uwp_sample["UWP Sample"]
  node_uwp_settings["UWP Settings<br/>[Settings.cs]"]
end

subgraph group_specialized["Specialized Samples"]
  node_composition_sample["Composition Sample"]
  node_cdp_extension["CDP Extension Sample<br/>[MainWindow.xaml.cs]"]
end

node_developer(("Developer"))
node_worker_runtime["WebView2 Runtime"]
node_web_content["Web Content"]

node_developer -->|"runs sample"| node_winforms_tutorial
node_developer -.->|"runs sample"| node_win32_tutorial
node_developer -.->|"runs sample"| node_wpf_tutorial
node_developer -.->|"runs sample"| node_winui_tutorials
node_developer -.->|"explores APIs"| node_api_app
node_developer -->|"runs sample"| node_winforms_browser
node_developer -.->|"runs sample"| node_wpf_browser
node_developer -->|"runs sample"| node_uwp_sample
node_developer -.->|"runs sample"| node_composition_sample
node_developer -.->|"runs sample"| node_cdp_extension
node_api_window -->|"owns components"| node_component_framework
node_service_workers -->|"extends"| node_component_framework
node_shared_workers -->|"extends"| node_component_framework
node_service_workers -->|"queries worker state"| node_worker_runtime
node_shared_workers -->|"queries worker state"| node_worker_runtime
node_service_workers -->|"reports events"| node_api_window
node_shared_workers -->|"reports events"| node_api_window
node_winforms_browser -->|"uses dialog"| node_browser_dialogs
node_winforms_browser -->|"uses monitor"| node_event_monitor
node_uwp_sample -->|"initializes settings"| node_uwp_settings
node_winforms_tutorial -.->|"hosts WebView2"| node_worker_runtime
node_win32_tutorial -.->|"hosts WebView2"| node_worker_runtime
node_wpf_tutorial -.->|"hosts WebView2"| node_worker_runtime
node_api_window -.->|"hosts WebView2"| node_worker_runtime
node_winforms_browser -.->|"hosts WebView2"| node_worker_runtime
node_wpf_browser -.->|"hosts WebView2"| node_worker_runtime
node_uwp_sample -.->|"hosts WebView2"| node_worker_runtime
node_composition_sample -.->|"hosts WebView2"| node_worker_runtime
node_cdp_extension -.->|"uses DevTools"| node_worker_runtime
node_worker_runtime -.->|"renders"| node_web_content

click node_winforms_tutorial "https://github.com/microsoftedge/webview2samples/blob/main/GettingStartedGuides/WinForms_GettingStarted/Form1.cs"
click node_win32_tutorial "https://github.com/microsoftedge/webview2samples/blob/main/GettingStartedGuides/Win32_GettingStarted/HelloWebView.cpp"
click node_wpf_tutorial "https://github.com/microsoftedge/webview2samples/blob/main/GettingStartedGuides/WPF_GettingStarted/MainWindow.xaml.cs"
click node_winui_tutorials "https://github.com/microsoftedge/webview2samples/tree/main/GettingStartedGuides"
click node_api_app "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/App.cpp"
click node_api_window "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/AppWindow.h"
click node_component_framework "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/ComponentBase.h"
click node_service_workers "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/ScenarioServiceWorkerManager.cpp"
click node_shared_workers "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/ScenarioSharedWorkerManager.cpp"
click node_winforms_browser "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WindowsFormsBrowser/BrowserForm.cs"
click node_browser_dialogs "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WindowsFormsBrowser/ClientCertificateSelectionDialog.cs"
click node_event_monitor "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WindowsFormsBrowser/EventMonitor.cs"
click node_wpf_browser "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WpfBrowser/MainWindow.xaml.cs"
click node_uwp_sample "https://github.com/microsoftedge/webview2samples/tree/main/SampleApps/webview2_sample_uwp/Pages"
click node_uwp_settings "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/webview2_sample_uwp/Settings.cs"
click node_composition_sample "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2SampleWinComp/CompositionHost.cpp"
click node_cdp_extension "https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WV2CDPExtensionWPFSample/MainWindow.xaml.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_winforms_tutorial,node_win32_tutorial,node_wpf_tutorial,node_winui_tutorials,node_worker_runtime toneBlue
class node_api_app,node_api_window,node_component_framework,node_service_workers,node_shared_workers toneAmber
class node_winforms_browser,node_browser_dialogs,node_event_monitor,node_wpf_browser,node_uwp_sample,node_uwp_settings toneMint
class node_composition_sample,node_cdp_extension toneRose
class node_developer,node_web_content toneIndigo
```

## Components

### Getting Started

- [WinForms Tutorial](https://github.com/microsoftedge/webview2samples/blob/main/GettingStartedGuides/WinForms_GettingStarted/Form1.cs): `GettingStartedGuides/WinForms_GettingStarted/Form1.cs`
- [Win32 Tutorial](https://github.com/microsoftedge/webview2samples/blob/main/GettingStartedGuides/Win32_GettingStarted/HelloWebView.cpp): `GettingStartedGuides/Win32_GettingStarted/HelloWebView.cpp`
- [WPF Tutorial](https://github.com/microsoftedge/webview2samples/blob/main/GettingStartedGuides/WPF_GettingStarted/MainWindow.xaml.cs): `GettingStartedGuides/WPF_GettingStarted/MainWindow.xaml.cs`
- [WinUI Tutorials](https://github.com/microsoftedge/webview2samples/tree/main/GettingStartedGuides): `GettingStartedGuides`

### Native API Sample

- [API Sample App](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/App.cpp): `SampleApps/WebView2APISample/App.cpp`
- [App Window](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/AppWindow.h): `SampleApps/WebView2APISample/AppWindow.h`
- [Component Framework](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/ComponentBase.h): `SampleApps/WebView2APISample/ComponentBase.h`
- [Service Workers](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/ScenarioServiceWorkerManager.cpp): `SampleApps/WebView2APISample/ScenarioServiceWorkerManager.cpp`
- [Shared Workers](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2APISample/ScenarioSharedWorkerManager.cpp): `SampleApps/WebView2APISample/ScenarioSharedWorkerManager.cpp`

### Browser Samples

- [WinForms Browser](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WindowsFormsBrowser/BrowserForm.cs): `SampleApps/WebView2WindowsFormsBrowser/BrowserForm.cs`
- [Browser Dialogs](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WindowsFormsBrowser/ClientCertificateSelectionDialog.cs): `SampleApps/WebView2WindowsFormsBrowser/ClientCertificateSelectionDialog.cs`
- [Event Monitor](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WindowsFormsBrowser/EventMonitor.cs): `SampleApps/WebView2WindowsFormsBrowser/EventMonitor.cs`
- [WPF Browser](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2WpfBrowser/MainWindow.xaml.cs): `SampleApps/WebView2WpfBrowser/MainWindow.xaml.cs`
- [UWP Sample](https://github.com/microsoftedge/webview2samples/tree/main/SampleApps/webview2_sample_uwp/Pages): `SampleApps/webview2_sample_uwp/Pages`
- [UWP Settings](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/webview2_sample_uwp/Settings.cs): `SampleApps/webview2_sample_uwp/Settings.cs`

### Specialized Samples

- [Composition Sample](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WebView2SampleWinComp/CompositionHost.cpp): `SampleApps/WebView2SampleWinComp/CompositionHost.cpp`
- [CDP Extension Sample](https://github.com/microsoftedge/webview2samples/blob/main/SampleApps/WV2CDPExtensionWPFSample/MainWindow.xaml.cs): `SampleApps/WV2CDPExtensionWPFSample/MainWindow.xaml.cs`

### Other components

- **Developer**
- **WebView2 Runtime**
- **Web Content**

## Connections

- Developer → WinForms Tutorial: runs sample
- Developer → Win32 Tutorial: runs sample (evidence: `README.md`)
- Developer → WPF Tutorial: runs sample (evidence: `README.md`)
- Developer → WinUI Tutorials: runs sample (evidence: `README.md`)
- Developer → API Sample App: explores APIs (evidence: `README.md`)
- Developer → WinForms Browser: runs sample
- Developer → WPF Browser: runs sample (evidence: `README.md`)
- Developer → UWP Sample: runs sample
- Developer → Composition Sample: runs sample (evidence: `README.md`)
- Developer → CDP Extension Sample: runs sample (evidence: `README.md`)
- App Window → Component Framework: owns components (evidence: `SampleApps/WebView2APISample/AppWindow.h`)
- Service Workers → Component Framework: extends
- Shared Workers → Component Framework: extends
- Service Workers → WebView2 Runtime: queries worker state (evidence: `SampleApps/WebView2APISample/ScenarioServiceWorkerManager.cpp`)
- Shared Workers → WebView2 Runtime: queries worker state (evidence: `SampleApps/WebView2APISample/ScenarioSharedWorkerManager.cpp`)
- Service Workers → App Window: reports events (evidence: `SampleApps/WebView2APISample/ScenarioServiceWorkerManager.cpp`)
- Shared Workers → App Window: reports events (evidence: `SampleApps/WebView2APISample/ScenarioSharedWorkerManager.cpp`)
- WinForms Browser → Browser Dialogs: uses dialog (evidence: `SampleApps/WebView2WindowsFormsBrowser/BrowserForm.cs`)
- WinForms Browser → Event Monitor: uses monitor (evidence: `SampleApps/WebView2WindowsFormsBrowser/BrowserForm.cs`)
- UWP Sample → UWP Settings: initializes settings
- WinForms Tutorial → WebView2 Runtime: hosts WebView2 (evidence: `README.md`)
- Win32 Tutorial → WebView2 Runtime: hosts WebView2 (evidence: `README.md`)
- WPF Tutorial → WebView2 Runtime: hosts WebView2 (evidence: `README.md`)
- App Window → WebView2 Runtime: hosts WebView2 (evidence: `SampleApps/WebView2APISample/AppWindow.h`)
- WinForms Browser → WebView2 Runtime: hosts WebView2 (evidence: `README.md`)
- WPF Browser → WebView2 Runtime: hosts WebView2 (evidence: `README.md`)
- UWP Sample → WebView2 Runtime: hosts WebView2 (evidence: `README.md`)
- Composition Sample → WebView2 Runtime: hosts WebView2 (evidence: `README.md`)
- CDP Extension Sample → WebView2 Runtime: uses DevTools (evidence: `README.md`)
- WebView2 Runtime → Web Content: renders (evidence: `README.md`)
