# allison0802/wardrobe-ai architecture

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

- Interactive diagram: https://gitdiagram.com/allison0802/wardrobe-ai
- Repository: https://github.com/allison0802/wardrobe-ai

## Overview

Wardrobe AI is a local-first wardrobe app for importing and reviewing owned garments, evaluating separate purchase candidates, and ranking outfits. The main workflow runs from the browser through server APIs: garment photos are analyzed into validated metadata before review and local persistence; purchase and outfit requests use owned-wardrobe metadata for decision support. The graph preserves those distinct stages and the shared taxonomy/retrieval layer. Several UI/API connections are documented rather than shown in sampled calls; those edges cite the README, and unsampled implementation details are omitted.

Main entry points: [`src/App.jsx`](https://github.com/allison0802/wardrobe-ai/blob/main/src/App.jsx) (Wardrobe app), [`scripts/purchase-evaluation-api.mjs`](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/purchase-evaluation-api.mjs) (Purchase evaluation), [`scripts/outfit-decision-api.mjs`](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/outfit-decision-api.mjs) (Outfit ranking), [`scripts/import-job-api.mjs`](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/import-job-api.mjs) (Import jobs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_wardrobe["Wardrobe experience"]
  node_app["Wardrobe app<br/>[App.jsx]"]
  node_editor["Metadata editor"]
  node_optimized["Optimized images<br/>[OptimizedImage.jsx]"]
end

subgraph group_import["Garment import"]
  node_import_ui["Import review<br/>[import-flow.jsx]"]
  node_import_api["Import jobs<br/>[import-job-api.mjs]"]
  node_normalization["Image normalization"]
  node_analysis["Gemini analysis"]
  node_image_api["Responsive images"]
end

subgraph group_decisions["Wardrobe decisions"]
  node_purchase_ui["Purchase review<br/>[PurchasePage.jsx]"]
  node_purchase_api["Purchase evaluation"]
  node_retrieval["Owned-item retrieval"]
  node_jev["JEV scoring client<br/>[jev-client.mjs]"]
  node_outfits_ui["Outfit planner<br/>[OutfitsPage.jsx]"]
  node_candidates["Outfit candidates"]
  node_outfit_api["Outfit ranking"]
end

subgraph group_domain["Shared domain"]
  node_wardrobe_store[("Wardrobe library")]
  node_taxonomy["Garment taxonomy"]
end

node_person(("Wardrobe user"))

node_person -->|"uses"| node_app
node_app -->|"opens"| node_editor
node_app -->|"renders"| node_optimized
node_app -->|"shows"| node_purchase_ui
node_app -->|"shows"| node_outfits_ui
node_app -->|"shows"| node_import_ui
node_import_ui -->|"renders"| node_editor
node_import_ui -->|"requests jobs"| node_import_api
node_import_api -->|"normalizes"| node_normalization
node_import_api -->|"analyzes garments"| node_analysis
node_analysis -->|"validates metadata"| node_taxonomy
node_import_api -->|"validates metadata"| node_taxonomy
node_import_api -->|"persists items"| node_wardrobe_store
node_person -->|"submits candidate"| node_purchase_ui
node_purchase_ui -->|"requests evaluation"| node_purchase_api
node_purchase_api -->|"normalizes image"| node_normalization
node_purchase_api -->|"analyzes candidate"| node_analysis
node_purchase_api -->|"validates metadata"| node_taxonomy
node_purchase_api -->|"reads owned items"| node_wardrobe_store
node_purchase_api -->|"retrieves owned items"| node_retrieval
node_retrieval -->|"validates metadata"| node_taxonomy
node_purchase_api -.->|"scores purchase"| node_jev
node_person -->|"sets preferences"| node_outfits_ui
node_outfits_ui -->|"requests ranking"| node_outfit_api
node_outfit_api -->|"reads wardrobe"| node_wardrobe_store
node_outfit_api -->|"builds combinations"| node_candidates
node_outfit_api -->|"projects metadata"| node_retrieval
node_outfit_api -->|"scores outfits"| node_jev
node_outfit_api -->|"validates request"| node_taxonomy
node_app -.->|"loads responsive images"| node_image_api

click node_app "https://github.com/allison0802/wardrobe-ai/blob/main/src/App.jsx"
click node_editor "https://github.com/allison0802/wardrobe-ai/blob/main/src/GarmentMetadataEditor.jsx"
click node_optimized "https://github.com/allison0802/wardrobe-ai/blob/main/src/OptimizedImage.jsx"
click node_import_ui "https://github.com/allison0802/wardrobe-ai/blob/main/src/import-flow.jsx"
click node_import_api "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/import-job-api.mjs"
click node_normalization "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/image-normalization.mjs"
click node_analysis "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/gemini-garment-analysis.mjs"
click node_image_api "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/responsive-image-api.mjs"
click node_taxonomy "https://github.com/allison0802/wardrobe-ai/blob/main/shared/garment-taxonomy.mjs"
click node_purchase_ui "https://github.com/allison0802/wardrobe-ai/blob/main/src/PurchasePage.jsx"
click node_purchase_api "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/purchase-evaluation-api.mjs"
click node_retrieval "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/wardrobe-retrieval.mjs"
click node_jev "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/jev-client.mjs"
click node_outfits_ui "https://github.com/allison0802/wardrobe-ai/blob/main/src/OutfitsPage.jsx"
click node_candidates "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/outfit-candidates.mjs"
click node_outfit_api "https://github.com/allison0802/wardrobe-ai/blob/main/scripts/outfit-decision-api.mjs"

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_app,node_editor,node_optimized,node_person toneBlue
class node_import_ui,node_import_api,node_normalization,node_analysis,node_image_api toneAmber
class node_purchase_ui,node_purchase_api,node_retrieval,node_jev,node_outfits_ui,node_candidates,node_outfit_api toneMint
class node_wardrobe_store,node_taxonomy toneRose
```

## Components

### Wardrobe experience

- [Wardrobe app](https://github.com/allison0802/wardrobe-ai/blob/main/src/App.jsx): `src/App.jsx`
- [Metadata editor](https://github.com/allison0802/wardrobe-ai/blob/main/src/GarmentMetadataEditor.jsx): `src/GarmentMetadataEditor.jsx`
- [Optimized images](https://github.com/allison0802/wardrobe-ai/blob/main/src/OptimizedImage.jsx): `src/OptimizedImage.jsx`

### Garment import

- [Import review](https://github.com/allison0802/wardrobe-ai/blob/main/src/import-flow.jsx): `src/import-flow.jsx`
- [Import jobs](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/import-job-api.mjs): `scripts/import-job-api.mjs`
- [Image normalization](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/image-normalization.mjs): `scripts/image-normalization.mjs`
- [Gemini analysis](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/gemini-garment-analysis.mjs): `scripts/gemini-garment-analysis.mjs`
- [Responsive images](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/responsive-image-api.mjs): `scripts/responsive-image-api.mjs`

### Wardrobe decisions

- [Purchase review](https://github.com/allison0802/wardrobe-ai/blob/main/src/PurchasePage.jsx): `src/PurchasePage.jsx`
- [Purchase evaluation](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/purchase-evaluation-api.mjs): `scripts/purchase-evaluation-api.mjs`
- [Owned-item retrieval](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/wardrobe-retrieval.mjs): `scripts/wardrobe-retrieval.mjs`
- [JEV scoring client](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/jev-client.mjs): `scripts/jev-client.mjs`
- [Outfit planner](https://github.com/allison0802/wardrobe-ai/blob/main/src/OutfitsPage.jsx): `src/OutfitsPage.jsx`
- [Outfit candidates](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/outfit-candidates.mjs): `scripts/outfit-candidates.mjs`
- [Outfit ranking](https://github.com/allison0802/wardrobe-ai/blob/main/scripts/outfit-decision-api.mjs): `scripts/outfit-decision-api.mjs`

### Shared domain

- **Wardrobe library**
- [Garment taxonomy](https://github.com/allison0802/wardrobe-ai/blob/main/shared/garment-taxonomy.mjs): `shared/garment-taxonomy.mjs`

### Other components

- **Wardrobe user**

## Connections

- Wardrobe user → Wardrobe app: uses (evidence: `README.md`)
- Wardrobe app → Metadata editor: opens (evidence: `src/App.jsx`)
- Wardrobe app → Optimized images: renders (evidence: `src/App.jsx`)
- Wardrobe app → Purchase review: shows (evidence: `src/App.jsx`)
- Wardrobe app → Outfit planner: shows (evidence: `src/App.jsx`)
- Wardrobe app → Import review: shows (evidence: `src/App.jsx`)
- Import review → Metadata editor: renders (evidence: `src/import-flow.jsx`)
- Import review → Import jobs: requests jobs (evidence: `src/import-flow.jsx`)
- Import jobs → Image normalization: normalizes (evidence: `scripts/import-job-api.mjs`)
- Import jobs → Gemini analysis: analyzes garments (evidence: `scripts/import-job-api.mjs`)
- Gemini analysis → Garment taxonomy: validates metadata (evidence: `scripts/gemini-garment-analysis.mjs`)
- Import jobs → Garment taxonomy: validates metadata (evidence: `scripts/import-job-api.mjs`)
- Import jobs → Wardrobe library: persists items (evidence: `README.md`)
- Wardrobe user → Purchase review: submits candidate (evidence: `README.md`)
- Purchase review → Purchase evaluation: requests evaluation (evidence: `src/PurchasePage.jsx`)
- Purchase evaluation → Image normalization: normalizes image (evidence: `scripts/purchase-evaluation-api.mjs`)
- Purchase evaluation → Gemini analysis: analyzes candidate (evidence: `scripts/purchase-evaluation-api.mjs`)
- Purchase evaluation → Garment taxonomy: validates metadata (evidence: `scripts/purchase-evaluation-api.mjs`)
- Purchase evaluation → Wardrobe library: reads owned items (evidence: `README.md`)
- Purchase evaluation → Owned-item retrieval: retrieves owned items (evidence: `scripts/purchase-evaluation-api.mjs`)
- Owned-item retrieval → Garment taxonomy: validates metadata (evidence: `scripts/wardrobe-retrieval.mjs`)
- Purchase evaluation → JEV scoring client: scores purchase (evidence: `scripts/purchase-evaluation-api.mjs`)
- Wardrobe user → Outfit planner: sets preferences (evidence: `README.md`)
- Outfit planner → Outfit ranking: requests ranking (evidence: `README.md`)
- Outfit ranking → Wardrobe library: reads wardrobe (evidence: `scripts/outfit-decision-api.mjs`)
- Outfit ranking → Outfit candidates: builds combinations (evidence: `scripts/outfit-decision-api.mjs`)
- Outfit ranking → Owned-item retrieval: projects metadata (evidence: `scripts/outfit-decision-api.mjs`)
- Outfit ranking → JEV scoring client: scores outfits (evidence: `scripts/outfit-decision-api.mjs`)
- Outfit ranking → Garment taxonomy: validates request (evidence: `scripts/outfit-decision-api.mjs`)
- Wardrobe app → Responsive images: loads responsive images
