# wixtoolset/wix3 architecture

> Architecture diagram of the GitHub repository wixtoolset/wix3, 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/wixtoolset/wix3
- Repository: https://github.com/wixtoolset/wix3

## Overview

WiX v3 is a Windows installer toolset: developers author XML and use its command-line tools to produce MSI packages and executable bundles. The repository also contains Burn, the bundle runtime, DTF libraries for archive and Windows Installer operations, and extensions that add installer authoring capabilities. The sampled evidence supports the documented product workflow and several module references; Burn’s internal execution links and unsampled extension wiring are therefore shown only as unverified where useful.

Main entry points: [`src/burn/engine/engine.cpp`](https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/engine.cpp) (Burn engine), [`src/tools/wix`](https://github.com/wixtoolset/wix3/tree/master/src/tools/wix) (WiX toolchain), [`src/burn/engine/apply.cpp`](https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/apply.cpp) (Apply actions), [`src/ext/BalExtension/mba/core/Engine.cs`](https://github.com/wixtoolset/wix3/blob/master/src/ext/BalExtension/mba/core/Engine.cs) (Bootstrapper application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring and packaging"]
  node_wix["WiX toolchain"]
  node_output["Intermediate output<br/>[Output.cs]"]
  node_binder["File binder"]
end

subgraph group_runtime["Bundle runtime"]
  node_burn["Burn engine<br/>[engine.cpp]"]
  node_detect["Detect packages<br/>[detect.cpp]"]
  node_plan["Plan actions<br/>[plan.cpp]"]
  node_apply["Apply actions<br/>[apply.cpp]"]
  node_package["Package engines<br/>[package.cpp]"]
end

subgraph group_libraries["Installer libraries"]
  node_compression["Compression core"]
  node_cab["Cabinet archives<br/>[CabEngine.cs]"]
  node_zip["Zip archives<br/>[ZipEngine.cs]"]
  node_msiapi["Windows Installer API<br/>[Handle.cs]"]
  node_query["Installer queries<br/>[DatabaseQuery.cs]"]
  node_linq["Installer LINQ<br/>[Query.cs]"]
end

subgraph group_extensions["Extensions"]
  node_extensions["Authoring extensions"]
  node_bootstrapper["Bootstrapper application<br/>[Engine.cs]"]
  node_wixba["WixBA interface<br/>[RootViewModel.cs]"]
end

node_developer(("Developer"))
node_xml["XML source"]
node_msi["MSI package"]
node_bundle["Executable bundle"]

node_developer -->|"authors"| node_xml
node_xml -->|"builds packages"| node_wix
node_wix -->|"produces MSI"| node_msi
node_wix -->|"produces bundles"| node_bundle
node_output -->|"references"| node_binder
node_bundle -.->|"runs bundle"| node_burn
node_burn -.->|"detects packages"| node_detect
node_burn -.->|"plans actions"| node_plan
node_burn -.->|"applies actions"| node_apply
node_apply -.->|"dispatches packages"| node_package
node_cab -->|"extends core"| node_compression
node_zip -->|"extends core"| node_compression
node_query -->|"uses handles"| node_msiapi
node_linq -->|"uses handles"| node_msiapi
node_extensions -.->|"extends authoring"| node_wix
node_bootstrapper -.->|"uses engine interface"| node_burn
node_wixba -.->|"provides UI"| node_bootstrapper

click node_wix "https://github.com/wixtoolset/wix3/tree/master/src/tools/wix"
click node_output "https://github.com/wixtoolset/wix3/blob/master/src/tools/wix/Output.cs"
click node_binder "https://github.com/wixtoolset/wix3/blob/master/src/tools/wix/BinderFileManager.cs"
click node_burn "https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/engine.cpp"
click node_detect "https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/detect.cpp"
click node_plan "https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/plan.cpp"
click node_apply "https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/apply.cpp"
click node_package "https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/package.cpp"
click node_compression "https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/Compression/CompressionEngine.cs"
click node_cab "https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/Compression.Cab/CabEngine.cs"
click node_zip "https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/Compression.Zip/ZipEngine.cs"
click node_msiapi "https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/WindowsInstaller/Handle.cs"
click node_query "https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/WindowsInstaller/DatabaseQuery.cs"
click node_linq "https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/WindowsInstaller.Linq/Query.cs"
click node_extensions "https://github.com/wixtoolset/wix3/tree/master/src/ext"
click node_bootstrapper "https://github.com/wixtoolset/wix3/blob/master/src/ext/BalExtension/mba/core/Engine.cs"
click node_wixba "https://github.com/wixtoolset/wix3/blob/master/src/Setup/WixBA/RootViewModel.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_wix,node_output,node_binder toneBlue
class node_burn,node_detect,node_plan,node_apply,node_package toneAmber
class node_compression,node_cab,node_zip,node_msiapi,node_query,node_linq toneMint
class node_extensions,node_bootstrapper,node_wixba toneRose
class node_developer,node_xml,node_msi,node_bundle toneIndigo
```

## Components

### Authoring and packaging

- [WiX toolchain](https://github.com/wixtoolset/wix3/tree/master/src/tools/wix): `src/tools/wix`
- [Intermediate output](https://github.com/wixtoolset/wix3/blob/master/src/tools/wix/Output.cs): `src/tools/wix/Output.cs`
- [File binder](https://github.com/wixtoolset/wix3/blob/master/src/tools/wix/BinderFileManager.cs): `src/tools/wix/BinderFileManager.cs`

### Bundle runtime

- [Burn engine](https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/engine.cpp): `src/burn/engine/engine.cpp`
- [Detect packages](https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/detect.cpp): `src/burn/engine/detect.cpp`
- [Plan actions](https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/plan.cpp): `src/burn/engine/plan.cpp`
- [Apply actions](https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/apply.cpp): `src/burn/engine/apply.cpp`
- [Package engines](https://github.com/wixtoolset/wix3/blob/master/src/burn/engine/package.cpp): `src/burn/engine/package.cpp`

### Installer libraries

- [Compression core](https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/Compression/CompressionEngine.cs): `src/DTF/Libraries/Compression/CompressionEngine.cs`
- [Cabinet archives](https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/Compression.Cab/CabEngine.cs): `src/DTF/Libraries/Compression.Cab/CabEngine.cs`
- [Zip archives](https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/Compression.Zip/ZipEngine.cs): `src/DTF/Libraries/Compression.Zip/ZipEngine.cs`
- [Windows Installer API](https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/WindowsInstaller/Handle.cs): `src/DTF/Libraries/WindowsInstaller/Handle.cs`
- [Installer queries](https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/WindowsInstaller/DatabaseQuery.cs): `src/DTF/Libraries/WindowsInstaller/DatabaseQuery.cs`
- [Installer LINQ](https://github.com/wixtoolset/wix3/blob/master/src/DTF/Libraries/WindowsInstaller.Linq/Query.cs): `src/DTF/Libraries/WindowsInstaller.Linq/Query.cs`

### Extensions

- [Authoring extensions](https://github.com/wixtoolset/wix3/tree/master/src/ext): `src/ext`
- [Bootstrapper application](https://github.com/wixtoolset/wix3/blob/master/src/ext/BalExtension/mba/core/Engine.cs): `src/ext/BalExtension/mba/core/Engine.cs`
- [WixBA interface](https://github.com/wixtoolset/wix3/blob/master/src/Setup/WixBA/RootViewModel.cs): `src/Setup/WixBA/RootViewModel.cs`

### Other components

- **Developer**
- **XML source**
- **MSI package**
- **Executable bundle**

## Connections

- Developer → XML source: authors
- XML source → WiX toolchain: builds packages
- WiX toolchain → MSI package: produces MSI
- WiX toolchain → Executable bundle: produces bundles
- Intermediate output → File binder: references (evidence: `src/tools/wix/Output.cs`)
- Executable bundle → Burn engine: runs bundle
- Burn engine → Detect packages: detects packages
- Burn engine → Plan actions: plans actions
- Burn engine → Apply actions: applies actions
- Apply actions → Package engines: dispatches packages
- Cabinet archives → Compression core: extends core (evidence: `src/DTF/Libraries/Compression.Cab/CabEngine.cs`)
- Zip archives → Compression core: extends core (evidence: `src/DTF/Libraries/Compression.Zip/ZipEngine.cs`)
- Installer queries → Windows Installer API: uses handles (evidence: `src/DTF/Libraries/WindowsInstaller/DatabaseQuery.cs`)
- Installer LINQ → Windows Installer API: uses handles
- Authoring extensions → WiX toolchain: extends authoring
- Bootstrapper application → Burn engine: uses engine interface
- WixBA interface → Bootstrapper application: provides UI
