# rbalsleymsft/ffu architecture

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

- Interactive diagram: https://gitdiagram.com/rbalsleymsft/ffu
- Repository: https://github.com/rbalsleymsft/ffu

## Overview

FFU Builder creates Windows deployment media containing a prepared Windows image; the documented workflow downloads Windows and updates, then creates a USB drive for rapid reimaging. After setup, devices can proceed through Autopilot or provisioning. The README also documents OEM drivers, Winget and bring-your-own apps, ARM64, and custom WinRE. Source excerpts were not provided, so implementation links below are limited to relationships the README explicitly describes; paths identify likely entry points or the exact available subsystem directories.

Main entry points: [`FFUDevelopment/BuildFFUVM.ps1`](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/BuildFFUVM.ps1) (VM build script), [`FFUDevelopment/BuildFFUVM_UI.ps1`](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/BuildFFUVM_UI.ps1) (Builder UI), [`FFUDevelopment/USBImagingToolCreator.ps1`](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/USBImagingToolCreator.ps1) (USB media creation), [`FFUDevelopment/WinPEDeployFFUFiles/ApplyFFU.ps1`](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/WinPEDeployFFUFiles/ApplyFFU.ps1) (Apply FFU)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_build["Image building"]
  node_builder_ui["Builder UI<br/>[BuildFFUVM_UI.ps1]"]
  node_build_engine["VM build script<br/>[BuildFFUVM.ps1]"]
  node_windows_image["Windows image"]
  node_windows_updates["Windows updates<br/>[FFU.Common]"]
end

subgraph group_customize["Image customization"]
  node_office["Microsoft 365 Apps"]
  node_applications["App configuration"]
  node_winget["Winget support"]
  node_drivers["OEM drivers"]
  node_byo_drivers["Custom drivers"]
  node_architecture["ARM64 support<br/>[unattend_arm64.xml]"]
  node_winre["Custom WinRE"]
  node_app_orchestration["App orchestration<br/>[Orchestrator.ps1]"]
  node_unattend["Windows setup config"]
end

subgraph group_media["Deployment media"]
  node_usb_media["USB media creation"]
  node_pe_media["WinPE media<br/>[Create-PEMedia.ps1]"]
  node_apply_image["Apply FFU<br/>[ApplyFFU.ps1]"]
end

subgraph group_setup["Device setup"]
  node_device(("Target device"))
  node_provisioning["Autopilot or provisioning"]
end

node_operator(("FFU operator"))

node_operator -->|"creates image"| node_builder_ui
node_builder_ui -->|"builds with"| node_build_engine
node_build_engine -->|"downloads Windows"| node_windows_image
node_build_engine -->|"adds updates"| node_windows_updates
node_build_engine -->|"adds Office"| node_office
node_build_engine -->|"adds OEM drivers"| node_drivers
node_build_engine -->|"integrates apps"| node_winget
node_operator -->|"supplies apps"| node_applications
node_operator -->|"supplies drivers"| node_byo_drivers
node_build_engine -->|"supports ARM64"| node_architecture
node_build_engine -->|"supports custom WinRE"| node_winre
node_build_engine -->|"creates USB"| node_usb_media
node_usb_media -.->|"includes deployment media"| node_pe_media
node_device -->|"receives image"| node_apply_image
node_apply_image -->|"reimages quickly"| node_device
node_device -->|"continues setup"| node_provisioning

click node_builder_ui "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/BuildFFUVM_UI.ps1"
click node_build_engine "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/BuildFFUVM.ps1"
click node_windows_image "https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/FFU"
click node_windows_updates "https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/FFU.Common"
click node_office "https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/Apps/Office"
click node_applications "https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/Apps"
click node_winget "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/FFU.Common/FFU.Common.Winget.psm1"
click node_drivers "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/FFU.Common/FFU.Common.Drivers.psm1"
click node_byo_drivers "https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/Drivers"
click node_architecture "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/BuildFFUUnattend/unattend_arm64.xml"
click node_winre "https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/FFU"
click node_app_orchestration "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/Apps/Orchestration/Orchestrator.ps1"
click node_unattend "https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/unattend"
click node_usb_media "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/USBImagingToolCreator.ps1"
click node_pe_media "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/Create-PEMedia.ps1"
click node_apply_image "https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/WinPEDeployFFUFiles/ApplyFFU.ps1"

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_builder_ui,node_build_engine,node_windows_image,node_windows_updates toneBlue
class node_office,node_applications,node_winget,node_drivers,node_byo_drivers,node_architecture,node_winre,node_app_orchestration,node_unattend toneAmber
class node_usb_media,node_pe_media,node_apply_image toneMint
class node_device,node_provisioning toneRose
class node_operator toneIndigo
```

## Components

### Image building

- [Builder UI](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/BuildFFUVM_UI.ps1): `FFUDevelopment/BuildFFUVM_UI.ps1`
- [VM build script](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/BuildFFUVM.ps1): `FFUDevelopment/BuildFFUVM.ps1`
- [Windows image](https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/FFU): `FFUDevelopment/FFU`
- [Windows updates](https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/FFU.Common): `FFUDevelopment/FFU.Common`

### Image customization

- [Microsoft 365 Apps](https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/Apps/Office): `FFUDevelopment/Apps/Office`
- [App configuration](https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/Apps): `FFUDevelopment/Apps`
- [Winget support](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/FFU.Common/FFU.Common.Winget.psm1): `FFUDevelopment/FFU.Common/FFU.Common.Winget.psm1`
- [OEM drivers](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/FFU.Common/FFU.Common.Drivers.psm1): `FFUDevelopment/FFU.Common/FFU.Common.Drivers.psm1`
- [Custom drivers](https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/Drivers): `FFUDevelopment/Drivers`
- [ARM64 support](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/BuildFFUUnattend/unattend_arm64.xml): `FFUDevelopment/BuildFFUUnattend/unattend_arm64.xml`
- [Custom WinRE](https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/FFU): `FFUDevelopment/FFU`
- [App orchestration](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/Apps/Orchestration/Orchestrator.ps1): `FFUDevelopment/Apps/Orchestration/Orchestrator.ps1`
- [Windows setup config](https://github.com/rbalsleymsft/ffu/tree/main/FFUDevelopment/unattend): `FFUDevelopment/unattend`

### Deployment media

- [USB media creation](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/USBImagingToolCreator.ps1): `FFUDevelopment/USBImagingToolCreator.ps1`
- [WinPE media](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/Create-PEMedia.ps1): `FFUDevelopment/Create-PEMedia.ps1`
- [Apply FFU](https://github.com/rbalsleymsft/ffu/blob/main/FFUDevelopment/WinPEDeployFFUFiles/ApplyFFU.ps1): `FFUDevelopment/WinPEDeployFFUFiles/ApplyFFU.ps1`

### Device setup

- **Target device**
- **Autopilot or provisioning**

### Other components

- **FFU operator**

## Connections

- FFU operator → Builder UI: creates image (evidence: `README.md`)
- Builder UI → VM build script: builds with (evidence: `README.md`)
- VM build script → Windows image: downloads Windows (evidence: `README.md`)
- VM build script → Windows updates: adds updates (evidence: `README.md`)
- VM build script → Microsoft 365 Apps: adds Office (evidence: `README.md`)
- VM build script → OEM drivers: adds OEM drivers (evidence: `README.md`)
- VM build script → Winget support: integrates apps (evidence: `README.md`)
- FFU operator → App configuration: supplies apps (evidence: `README.md`)
- FFU operator → Custom drivers: supplies drivers (evidence: `README.md`)
- VM build script → ARM64 support: supports ARM64 (evidence: `README.md`)
- VM build script → Custom WinRE: supports custom WinRE (evidence: `README.md`)
- VM build script → USB media creation: creates USB (evidence: `README.md`)
- USB media creation → WinPE media: includes deployment media
- Target device → Apply FFU: receives image (evidence: `README.md`)
- Apply FFU → Target device: reimages quickly (evidence: `README.md`)
- Target device → Autopilot or provisioning: continues setup (evidence: `README.md`)
