# vickyilovemymother/vp_fashion_configurator architecture

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

- Interactive diagram: https://gitdiagram.com/vickyilovemymother/vp_fashion_configurator
- Repository: https://github.com/vickyilovemymother/vp_fashion_configurator

## Overview

This is a browser-based 3D virtual product configurator: users choose garments and appearance options, view them in a rendered scene, and can export product imagery or data. The principal flow runs from UI actions through the application coordinator and state to garment, mannequin, environment, and scene systems. The repository contains parallel `src/vp-configurator` and `vp-configurator` implementations; this graph uses the latter, whose sampled modules show richer export and XR capabilities. Some coordinator wiring and unsampled capabilities are supported only by imports or documentation, so uncertain links are omitted.

Main entry points: [`vp-configurator/main.js`](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/main.js) (App coordinator), [`vp-configurator/controllers/UIController.js`](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/UIController.js) (Configurator UI), [`vp-configurator/controllers/GarmentController.js`](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/GarmentController.js) (Garment selection), [`vp-configurator/controllers/MannequinController.js`](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/MannequinController.js) (Mannequin selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Configurator experience"]
  node_ui["Configurator UI<br/>[UIController.js]"]
  node_app["App coordinator<br/>[main.js]"]
  node_state["Configuration state<br/>[StateManager.js]"]
  node_colors["Color controls<br/>[ColorController.js]"]
end

subgraph group_scene["3D scene"]
  node_loader["3D model loader<br/>[ModelLoader.js]"]
  node_scenegraph["Scene and renderer<br/>[SceneManager.js]"]
  node_camera["Camera controls<br/>[CameraManager.js]"]
  node_environment["Lighting and HDR"]
end

subgraph group_assets["Product assets"]
  node_garments["Garment selection"]
  node_mannequin["Mannequin selection"]
  node_garmentconfig["Garment catalog<br/>[garmentConfig.json]"]
  node_models["Garment models"]
  node_mannequins["Mannequin models"]
end

subgraph group_sharing["Export and sharing"]
  node_export["Product export"]
  node_urlstate["Shareable URL state<br/>[URLUtils.js]"]
  node_presets["Preset utilities<br/>[PresetUtils.js]"]
end

node_shopper(("Configurator user"))

node_shopper -->|"chooses options"| node_ui
node_app -->|"initializes"| node_ui
node_app -->|"initializes"| node_state
node_app -->|"initializes"| node_scenegraph
node_app -->|"initializes"| node_camera
node_app -->|"initializes"| node_environment
node_app -->|"initializes"| node_loader
node_app -->|"initializes"| node_garments
node_app -->|"initializes"| node_mannequin
node_app -->|"initializes"| node_colors
node_app -->|"initializes"| node_export
node_ui -->|"updates"| node_state
node_ui -->|"uses"| node_urlstate
node_app -->|"loads config"| node_garmentconfig
node_garments -.->|"loads models"| node_loader
node_mannequin -.->|"loads models"| node_loader
node_garments -.->|"loads assets"| node_models
node_mannequin -.->|"loads assets"| node_mannequins
node_app -.->|"configures scene"| node_scenegraph
node_app -.->|"configures lighting"| node_environment
node_export -->|"captures scene"| node_scenegraph
node_app -->|"dispatches export"| node_export
node_ui -.->|"uses presets"| node_presets

click node_ui "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/UIController.js"
click node_app "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/main.js"
click node_state "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/core/StateManager.js"
click node_garments "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/GarmentController.js"
click node_mannequin "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/MannequinController.js"
click node_garmentconfig "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/config/garmentConfig.json"
click node_models "https://github.com/vickyilovemymother/vp_fashion_configurator/tree/main/public/assets/models"
click node_mannequins "https://github.com/vickyilovemymother/vp_fashion_configurator/tree/main/public/assets/mannequins"
click node_loader "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/core/ModelLoader.js"
click node_scenegraph "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/core/SceneManager.js"
click node_camera "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/src/vp-configurator/core/CameraManager.js"
click node_environment "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/core/EnvironmentManager.js"
click node_colors "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/ColorController.js"
click node_export "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/ExportController.js"
click node_urlstate "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/utils/URLUtils.js"
click node_presets "https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/utils/PresetUtils.js"

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_ui,node_app,node_state,node_colors,node_shopper toneBlue
class node_loader,node_scenegraph,node_camera,node_environment toneAmber
class node_garments,node_mannequin,node_garmentconfig,node_models,node_mannequins toneMint
class node_export,node_urlstate,node_presets toneRose
```

## Components

### Configurator experience

- [Configurator UI](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/UIController.js): `vp-configurator/controllers/UIController.js`
- [App coordinator](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/main.js): `vp-configurator/main.js`
- [Configuration state](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/core/StateManager.js): `vp-configurator/core/StateManager.js`
- [Color controls](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/ColorController.js): `vp-configurator/controllers/ColorController.js`

### 3D scene

- [3D model loader](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/core/ModelLoader.js): `vp-configurator/core/ModelLoader.js`
- [Scene and renderer](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/core/SceneManager.js): `vp-configurator/core/SceneManager.js`
- [Camera controls](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/src/vp-configurator/core/CameraManager.js): `src/vp-configurator/core/CameraManager.js`
- [Lighting and HDR](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/core/EnvironmentManager.js): `vp-configurator/core/EnvironmentManager.js`

### Product assets

- [Garment selection](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/GarmentController.js): `vp-configurator/controllers/GarmentController.js`
- [Mannequin selection](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/MannequinController.js): `vp-configurator/controllers/MannequinController.js`
- [Garment catalog](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/config/garmentConfig.json): `vp-configurator/config/garmentConfig.json`
- [Garment models](https://github.com/vickyilovemymother/vp_fashion_configurator/tree/main/public/assets/models): `public/assets/models`
- [Mannequin models](https://github.com/vickyilovemymother/vp_fashion_configurator/tree/main/public/assets/mannequins): `public/assets/mannequins`

### Export and sharing

- [Product export](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/controllers/ExportController.js): `vp-configurator/controllers/ExportController.js`
- [Shareable URL state](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/utils/URLUtils.js): `vp-configurator/utils/URLUtils.js`
- [Preset utilities](https://github.com/vickyilovemymother/vp_fashion_configurator/blob/main/vp-configurator/utils/PresetUtils.js): `vp-configurator/utils/PresetUtils.js`

### Other components

- **Configurator user**

## Connections

- Configurator user → Configurator UI: chooses options (evidence: `vp-configurator/controllers/UIController.js`)
- App coordinator → Configurator UI: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → Configuration state: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → Scene and renderer: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → Camera controls: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → Lighting and HDR: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → 3D model loader: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → Garment selection: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → Mannequin selection: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → Color controls: initializes (evidence: `vp-configurator/main.js`)
- App coordinator → Product export: initializes (evidence: `vp-configurator/main.js`)
- Configurator UI → Configuration state: updates (evidence: `vp-configurator/controllers/UIController.js`)
- Configurator UI → Shareable URL state: uses (evidence: `vp-configurator/controllers/UIController.js`)
- App coordinator → Garment catalog: loads config (evidence: `vp-configurator/main.js`)
- Garment selection → 3D model loader: loads models
- Mannequin selection → 3D model loader: loads models
- Garment selection → Garment models: loads assets
- Mannequin selection → Mannequin models: loads assets
- App coordinator → Scene and renderer: configures scene (evidence: `vp-configurator/main.js`)
- App coordinator → Lighting and HDR: configures lighting (evidence: `vp-configurator/main.js`)
- Product export → Scene and renderer: captures scene (evidence: `vp-configurator/controllers/ExportController.js`)
- App coordinator → Product export: dispatches export (evidence: `vp-configurator/main.js`)
- Configurator UI → Preset utilities: uses presets
