# abhi-7-github/shaili architecture

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

## Overview

Shaili is a smart wardrobe and styling application: users authenticate, build a wardrobe from clothing images, then use styling, outfit, insight and virtual try-on features. The browser app routes protected experiences and calls an Express API; controllers coordinate persistence and image/AI services. The README gives no capability detail beyond the product name, so feature branches reflect the source index and tree; unsampled feature implementations are represented at their exact directories, and uncertain links are omitted.

Main entry points: [`client/src/App.jsx`](https://github.com/abhi-7-github/shaili/blob/main/client/src/App.jsx) (App routes), [`server/controllers/wardrobeController.js`](https://github.com/abhi-7-github/shaili/blob/main/server/controllers/wardrobeController.js) (Wardrobe operations), [`client/src/components/ShailiLandingPage.jsx`](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/ShailiLandingPage.jsx) (Wardrobe workspace), [`server/routes/wardrobeRoutes.js`](https://github.com/abhi-7-github/shaili/blob/main/server/routes/wardrobeRoutes.js) (Wardrobe routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_web["App routes<br/>[App.jsx]"]
  node_authui["Sign-in form<br/>[AuthForm.jsx]"]
  node_authctx["Auth state<br/>[AuthContext.jsx]"]
  node_voice["Voice commands"]
  node_landing["Wardrobe workspace"]
  node_wardrobecard["Wardrobe browsing<br/>[WardrobeGrid.jsx]"]
  node_uploadui["Wardrobe upload<br/>[UploadPage.jsx]"]
  node_assistant["AI assistant<br/>[AiAssistant.jsx]"]
  node_outfitui["Outfit builder<br/>[OutfitBuilder.jsx]"]
  node_insightsui["Style insights<br/>[InsightsCard.jsx]"]
  node_vtonui["Virtual try-on UI<br/>[VirtualTryOn.jsx]"]
  node_ar["AR viewer<br/>[ARViewer.jsx]"]
end

subgraph group_api["API and identity"]
  node_api["Express API<br/>[server.js]"]
  node_authroute["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Auth controller<br/>[authController.js]"]
  node_authmw["Token validation<br/>[authMiddleware.js]"]
  node_userdb[("User records<br/>[User.js]")]
end

subgraph group_wardrobe["Wardrobe intelligence"]
  node_wardroute["Wardrobe routes<br/>[wardrobeRoutes.js]"]
  node_wardcontroller["Wardrobe operations"]
  node_warddb[("Wardrobe items<br/>[WardrobeItem.js]")]
  node_vision["Garment analysis<br/>[vision.service.js]"]
  node_color["Color normalization<br/>[color.service.js]"]
  node_cloud["Image media storage"]
  node_insights["Wear insights"]
end

subgraph group_styling["Styling experiences"]
  node_outfit["Outfit service"]
  node_outfitdb[("Saved outfits<br/>[Outfit.js]")]
  node_stylist["AI stylist"]
  node_stylistservice["Styling logic<br/>[stylist.service.js]"]
  node_match["Garment matching"]
  node_vtonroute["Try-on routes"]
  node_vtoncontroller["Try-on controller"]
  node_vtonservice["Try-on orchestration"]
  node_vtonmanager["Provider manager"]
end

subgraph group_memory["Image memory"]
end

node_user(("Wardrobe user"))

node_user -->|"uses"| node_web
node_web -->|"routes to"| node_authui
node_web -->|"routes to"| node_landing
node_web -->|"routes to"| node_uploadui
node_web -->|"provides context"| node_voice
node_web -->|"provides context"| node_authctx
node_authui -->|"uses"| node_authctx
node_landing -->|"renders"| node_wardrobecard
node_landing -->|"renders"| node_assistant
node_landing -->|"renders"| node_outfitui
node_landing -->|"renders"| node_insightsui
node_web -->|"routes to"| node_ar
node_api -->|"mounts"| node_authroute
node_api -->|"mounts"| node_wardroute
node_api -->|"mounts"| node_vtonroute
node_authroute -->|"routes to"| node_authcontroller
node_authcontroller -->|"reads and writes"| node_userdb
node_authroute -->|"protects"| node_authmw
node_wardroute -->|"applies"| node_authmw
node_wardroute -->|"routes to"| node_wardcontroller
node_wardcontroller -->|"reads and writes"| node_warddb
node_wardcontroller -->|"analyzes garments"| node_vision
node_wardcontroller -->|"normalizes colors"| node_color
node_wardcontroller -->|"uploads images"| node_cloud
node_wardcontroller -->|"gets underused items"| node_insights
node_vision -->|"uses"| node_color
node_outfit -->|"reads and writes"| node_outfitdb
node_vtonroute -->|"protects"| node_authmw
node_vtonroute -->|"dispatches"| node_vtoncontroller
node_vtoncontroller -->|"processes try-on"| node_vtonservice
node_vtonservice -.->|"delegates"| node_vtonmanager
node_vtonmanager -->|"stores output"| node_cloud
node_stylist -.->|"delegates"| node_stylistservice
node_stylistservice -.->|"uses"| node_match
node_wardrobecard -.->|"requests wardrobe"| node_wardroute
node_uploadui -.->|"uploads clothing"| node_wardroute
node_outfitui -.->|"requests outfits"| node_outfit
node_insightsui -.->|"requests insights"| node_insights
node_vtonui -.->|"submits images"| node_vtonroute

click node_web "https://github.com/abhi-7-github/shaili/blob/main/client/src/App.jsx"
click node_authui "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/AuthForm.jsx"
click node_authctx "https://github.com/abhi-7-github/shaili/blob/main/client/src/context/AuthContext.jsx"
click node_voice "https://github.com/abhi-7-github/shaili/blob/main/client/src/context/VoiceCommandContext.jsx"
click node_landing "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/ShailiLandingPage.jsx"
click node_wardrobecard "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/WardrobeGrid.jsx"
click node_uploadui "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/UploadPage.jsx"
click node_assistant "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/AiAssistant.jsx"
click node_outfitui "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/OutfitBuilder.jsx"
click node_insightsui "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/InsightsCard.jsx"
click node_vtonui "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/VirtualTryOn.jsx"
click node_ar "https://github.com/abhi-7-github/shaili/blob/main/client/src/components/ARViewer.jsx"
click node_api "https://github.com/abhi-7-github/shaili/blob/main/server/server.js"
click node_authroute "https://github.com/abhi-7-github/shaili/blob/main/server/routes/authRoutes.js"
click node_authcontroller "https://github.com/abhi-7-github/shaili/blob/main/server/controllers/authController.js"
click node_authmw "https://github.com/abhi-7-github/shaili/blob/main/server/middleware/authMiddleware.js"
click node_userdb "https://github.com/abhi-7-github/shaili/blob/main/server/models/User.js"
click node_wardroute "https://github.com/abhi-7-github/shaili/blob/main/server/routes/wardrobeRoutes.js"
click node_wardcontroller "https://github.com/abhi-7-github/shaili/blob/main/server/controllers/wardrobeController.js"
click node_warddb "https://github.com/abhi-7-github/shaili/blob/main/server/models/WardrobeItem.js"
click node_vision "https://github.com/abhi-7-github/shaili/blob/main/server/services/vision.service.js"
click node_color "https://github.com/abhi-7-github/shaili/blob/main/server/services/color.service.js"
click node_cloud "https://github.com/abhi-7-github/shaili/blob/main/server/services/cloudinary.service.js"
click node_insights "https://github.com/abhi-7-github/shaili/blob/main/server/services/insights.service.js"
click node_outfit "https://github.com/abhi-7-github/shaili/blob/main/server/controllers/outfitController.js"
click node_outfitdb "https://github.com/abhi-7-github/shaili/blob/main/server/models/Outfit.js"
click node_stylist "https://github.com/abhi-7-github/shaili/blob/main/server/controllers/stylistController.js"
click node_stylistservice "https://github.com/abhi-7-github/shaili/blob/main/server/services/stylist.service.js"
click node_match "https://github.com/abhi-7-github/shaili/blob/main/server/services/matching.service.js"
click node_vtonroute "https://github.com/abhi-7-github/shaili/blob/main/server/routes/virtualTryOnRoutes.js"
click node_vtoncontroller "https://github.com/abhi-7-github/shaili/blob/main/server/controllers/virtualTryOnController.js"
click node_vtonservice "https://github.com/abhi-7-github/shaili/blob/main/server/services/virtualTryOnService.js"
click node_vtonmanager "https://github.com/abhi-7-github/shaili/blob/main/server/services/vton/VTONProviderManager.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_web,node_authui,node_authctx,node_voice,node_landing,node_wardrobecard,node_uploadui,node_assistant,node_outfitui,node_insightsui,node_vtonui,node_ar,node_user toneBlue
class node_api,node_authroute,node_authcontroller,node_authmw,node_userdb toneAmber
class node_wardroute,node_wardcontroller,node_warddb,node_vision,node_color,node_cloud,node_insights toneMint
class node_outfit,node_outfitdb,node_stylist,node_stylistservice,node_match,node_vtonroute,node_vtoncontroller,node_vtonservice,node_vtonmanager toneRose
```

## Components

### Web application

- [App routes](https://github.com/abhi-7-github/shaili/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign-in form](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/AuthForm.jsx): `client/src/components/AuthForm.jsx`
- [Auth state](https://github.com/abhi-7-github/shaili/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Voice commands](https://github.com/abhi-7-github/shaili/blob/main/client/src/context/VoiceCommandContext.jsx): `client/src/context/VoiceCommandContext.jsx`
- [Wardrobe workspace](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/ShailiLandingPage.jsx): `client/src/components/ShailiLandingPage.jsx`
- [Wardrobe browsing](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/WardrobeGrid.jsx): `client/src/components/WardrobeGrid.jsx`
- [Wardrobe upload](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/UploadPage.jsx): `client/src/components/UploadPage.jsx`
- [AI assistant](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/AiAssistant.jsx): `client/src/components/AiAssistant.jsx`
- [Outfit builder](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/OutfitBuilder.jsx): `client/src/components/OutfitBuilder.jsx`
- [Style insights](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/InsightsCard.jsx): `client/src/components/InsightsCard.jsx`
- [Virtual try-on UI](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/VirtualTryOn.jsx): `client/src/components/VirtualTryOn.jsx`
- [AR viewer](https://github.com/abhi-7-github/shaili/blob/main/client/src/components/ARViewer.jsx): `client/src/components/ARViewer.jsx`

### API and identity

- [Express API](https://github.com/abhi-7-github/shaili/blob/main/server/server.js): `server/server.js`
- [Auth routes](https://github.com/abhi-7-github/shaili/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Auth controller](https://github.com/abhi-7-github/shaili/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Token validation](https://github.com/abhi-7-github/shaili/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [User records](https://github.com/abhi-7-github/shaili/blob/main/server/models/User.js): `server/models/User.js`

### Wardrobe intelligence

- [Wardrobe routes](https://github.com/abhi-7-github/shaili/blob/main/server/routes/wardrobeRoutes.js): `server/routes/wardrobeRoutes.js`
- [Wardrobe operations](https://github.com/abhi-7-github/shaili/blob/main/server/controllers/wardrobeController.js): `server/controllers/wardrobeController.js`
- [Wardrobe items](https://github.com/abhi-7-github/shaili/blob/main/server/models/WardrobeItem.js): `server/models/WardrobeItem.js`
- [Garment analysis](https://github.com/abhi-7-github/shaili/blob/main/server/services/vision.service.js): `server/services/vision.service.js`
- [Color normalization](https://github.com/abhi-7-github/shaili/blob/main/server/services/color.service.js): `server/services/color.service.js`
- [Image media storage](https://github.com/abhi-7-github/shaili/blob/main/server/services/cloudinary.service.js): `server/services/cloudinary.service.js`
- [Wear insights](https://github.com/abhi-7-github/shaili/blob/main/server/services/insights.service.js): `server/services/insights.service.js`

### Styling experiences

- [Outfit service](https://github.com/abhi-7-github/shaili/blob/main/server/controllers/outfitController.js): `server/controllers/outfitController.js`
- [Saved outfits](https://github.com/abhi-7-github/shaili/blob/main/server/models/Outfit.js): `server/models/Outfit.js`
- [AI stylist](https://github.com/abhi-7-github/shaili/blob/main/server/controllers/stylistController.js): `server/controllers/stylistController.js`
- [Styling logic](https://github.com/abhi-7-github/shaili/blob/main/server/services/stylist.service.js): `server/services/stylist.service.js`
- [Garment matching](https://github.com/abhi-7-github/shaili/blob/main/server/services/matching.service.js): `server/services/matching.service.js`
- [Try-on routes](https://github.com/abhi-7-github/shaili/blob/main/server/routes/virtualTryOnRoutes.js): `server/routes/virtualTryOnRoutes.js`
- [Try-on controller](https://github.com/abhi-7-github/shaili/blob/main/server/controllers/virtualTryOnController.js): `server/controllers/virtualTryOnController.js`
- [Try-on orchestration](https://github.com/abhi-7-github/shaili/blob/main/server/services/virtualTryOnService.js): `server/services/virtualTryOnService.js`
- [Provider manager](https://github.com/abhi-7-github/shaili/blob/main/server/services/vton/VTONProviderManager.js): `server/services/vton/VTONProviderManager.js`

### Other components

- **Wardrobe user**

## Connections

- Wardrobe user → App routes: uses (evidence: `client/src/App.jsx`)
- App routes → Sign-in form: routes to (evidence: `client/src/App.jsx`)
- App routes → Wardrobe workspace: routes to (evidence: `client/src/App.jsx`)
- App routes → Wardrobe upload: routes to (evidence: `client/src/App.jsx`)
- App routes → Voice commands: provides context (evidence: `client/src/App.jsx`)
- App routes → Auth state: provides context (evidence: `client/src/App.jsx`)
- Sign-in form → Auth state: uses (evidence: `client/src/components/AuthForm.jsx`)
- Wardrobe workspace → Wardrobe browsing: renders (evidence: `client/src/components/ShailiLandingPage.jsx`)
- Wardrobe workspace → AI assistant: renders (evidence: `client/src/components/ShailiLandingPage.jsx`)
- Wardrobe workspace → Outfit builder: renders (evidence: `client/src/components/ShailiLandingPage.jsx`)
- Wardrobe workspace → Style insights: renders (evidence: `client/src/components/ShailiLandingPage.jsx`)
- App routes → AR viewer: routes to (evidence: `client/src/App.jsx`)
- Express API → Auth routes: mounts (evidence: `server/server.js`)
- Express API → Wardrobe routes: mounts (evidence: `server/server.js`)
- Express API → Try-on routes: mounts (evidence: `server/server.js`)
- Auth routes → Auth controller: routes to (evidence: `server/routes/authRoutes.js`)
- Auth controller → User records: reads and writes (evidence: `server/controllers/authController.js`)
- Auth routes → Token validation: protects (evidence: `server/routes/authRoutes.js`)
- Wardrobe routes → Token validation: applies (evidence: `server/routes/wardrobeRoutes.js`)
- Wardrobe routes → Wardrobe operations: routes to (evidence: `server/routes/wardrobeRoutes.js`)
- Wardrobe operations → Wardrobe items: reads and writes (evidence: `server/controllers/wardrobeController.js`)
- Wardrobe operations → Garment analysis: analyzes garments (evidence: `server/controllers/wardrobeController.js`)
- Wardrobe operations → Color normalization: normalizes colors (evidence: `server/controllers/wardrobeController.js`)
- Wardrobe operations → Image media storage: uploads images (evidence: `server/controllers/wardrobeController.js`)
- Wardrobe operations → Wear insights: gets underused items (evidence: `server/controllers/wardrobeController.js`)
- Garment analysis → Color normalization: uses (evidence: `server/services/vision.service.js`)
- Outfit service → Saved outfits: reads and writes (evidence: `server/controllers/outfitController.js`)
- Try-on routes → Token validation: protects (evidence: `server/routes/virtualTryOnRoutes.js`)
- Try-on routes → Try-on controller: dispatches (evidence: `server/routes/virtualTryOnRoutes.js`)
- Try-on controller → Try-on orchestration: processes try-on (evidence: `server/controllers/virtualTryOnController.js`)
- Try-on orchestration → Provider manager: delegates
- Provider manager → Image media storage: stores output (evidence: `server/services/vton/VTONProviderManager.js`)
- AI stylist → Styling logic: delegates
- Styling logic → Garment matching: uses
- Wardrobe browsing → Wardrobe routes: requests wardrobe
- Wardrobe upload → Wardrobe routes: uploads clothing
- Outfit builder → Outfit service: requests outfits
- Style insights → Wear insights: requests insights
- Virtual try-on UI → Try-on routes: submits images
