# nigle99/virtualview-ios architecture

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

- Interactive diagram: https://gitdiagram.com/nigle99/virtualview-ios
- Repository: https://github.com/nigle99/virtualview-ios

## Overview

VirtualView is an iOS runtime for dynamically creating and displaying UI components described in XML and compiled to .out templates. The principal workflow is author XML, compile it, load the binary template, create a component, bind data and calculate layout, then display it. The graph includes the documented layout, widget, and specialized-view capabilities. Source excerpts are mostly API declarations, so edges beyond README-described workflow and explicitly documented manager behavior are omitted rather than inferred.

Main entry points: [`VirtualView/Core/VVViewContainer.h`](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Core/VVViewContainer.h) (View container), [`VirtualView/Loader/VVTemplateManager.h`](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Loader/VVTemplateManager.h) (Template manager), [`VirtualView/Loader`](https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Loader) (Template loaders), [`VirtualView/Core/VVBaseNode.h`](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Core/VVBaseNode.h) (Node tree)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_template["Template loading"]
  node_binary[".out template"]
  node_manager["Template manager"]
  node_loaders["Template loaders"]
end

subgraph group_component["Component runtime"]
  node_container["View container<br/>[VVViewContainer.h]"]
  node_node["Node tree<br/>[VVBaseNode.h]"]
  node_creator["Node creator<br/>[VVNodeCreater.h]"]
  node_setters["Property setters"]
end

subgraph group_presentation["Layouts and views"]
  node_layouts["Layout implementations"]
  node_widgets["Widgets and layers"]
  node_specialviews["Specialized views"]
end

subgraph group_support["Runtime support"]
  node_definitions["Runtime definitions<br/>[VVDefines.h]"]
  node_observers["Observer support<br/>[VVObserver.h]"]
  node_viewutils["View utilities"]
end

node_author(("Component author"))
node_xml["XML template"]
node_compiler["XML compiler"]
node_app(("iOS application"))

node_author -->|"describes"| node_xml
node_xml -->|"compiled by"| node_compiler
node_compiler -->|"produces"| node_binary
node_app -->|"loads template"| node_manager
node_manager -->|"loads"| node_binary
node_manager -->|"selects loader"| node_loaders
node_app -->|"creates component"| node_container
node_container -->|"creates tree"| node_node
node_app -->|"binds data"| node_container
node_app -->|"calculates layout"| node_container
node_app -->|"displays component"| node_container

click node_manager "https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Loader/VVTemplateManager.h"
click node_loaders "https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Loader"
click node_container "https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Core/VVViewContainer.h"
click node_node "https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Core/VVBaseNode.h"
click node_creator "https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Creater/VVNodeCreater.h"
click node_setters "https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Creater/Setter"
click node_layouts "https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Node/Layout"
click node_widgets "https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Node/Widget"
click node_specialviews "https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Node/Magic"
click node_definitions "https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Core/VVDefines.h"
click node_observers "https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Observer/VVObserver.h"
click node_viewutils "https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Utils/UIView%2BVirtualView.h"

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_binary,node_manager,node_loaders toneBlue
class node_container,node_node,node_creator,node_setters toneAmber
class node_layouts,node_widgets,node_specialviews toneMint
class node_definitions,node_observers,node_viewutils toneRose
class node_author,node_xml,node_compiler,node_app toneIndigo
```

## Components

### Template loading

- **.out template**
- [Template manager](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Loader/VVTemplateManager.h): `VirtualView/Loader/VVTemplateManager.h`
- [Template loaders](https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Loader): `VirtualView/Loader`

### Component runtime

- [View container](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Core/VVViewContainer.h): `VirtualView/Core/VVViewContainer.h`
- [Node tree](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Core/VVBaseNode.h): `VirtualView/Core/VVBaseNode.h`
- [Node creator](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Creater/VVNodeCreater.h): `VirtualView/Creater/VVNodeCreater.h`
- [Property setters](https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Creater/Setter): `VirtualView/Creater/Setter`

### Layouts and views

- [Layout implementations](https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Node/Layout): `VirtualView/Node/Layout`
- [Widgets and layers](https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Node/Widget): `VirtualView/Node/Widget`
- [Specialized views](https://github.com/nigle99/virtualview-ios/tree/master/VirtualView/Node/Magic): `VirtualView/Node/Magic`

### Runtime support

- [Runtime definitions](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Core/VVDefines.h): `VirtualView/Core/VVDefines.h`
- [Observer support](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Observer/VVObserver.h): `VirtualView/Observer/VVObserver.h`
- [View utilities](https://github.com/nigle99/virtualview-ios/blob/master/VirtualView/Utils/UIView%2BVirtualView.h): `VirtualView/Utils/UIView+VirtualView.h`

### Other components

- **Component author**
- **XML template**
- **XML compiler**
- **iOS application**

## Connections

- Component author → XML template: describes (evidence: `README`)
- XML template → XML compiler: compiled by (evidence: `README`)
- XML compiler → .out template: produces (evidence: `README`)
- iOS application → Template manager: loads template (evidence: `README`)
- Template manager → .out template: loads (evidence: `README`)
- Template manager → Template loaders: selects loader (evidence: `VirtualView/Loader/VVTemplateManager.h`)
- iOS application → View container: creates component (evidence: `README`)
- View container → Node tree: creates tree
- iOS application → View container: binds data (evidence: `README`)
- iOS application → View container: calculates layout (evidence: `README`)
- iOS application → View container: displays component (evidence: `README`)
