# ashmitkmishra/hackfashion-ai architecture

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

- Interactive diagram: https://gitdiagram.com/ashmitkmishra/hackfashion-ai
- Repository: https://github.com/ashmitkmishra/hackfashion-ai

## Overview

HackFashion-AI combines a promotional React landing app with a separate wardrobe-styling app and Express API. The principal workflow is upload clothing images, categorize them, build a wardrobe, then request occasion-aware outfit suggestions or converse with the voice stylist. The README also documents visual wardrobe browsing, speech input, and ElevenLabs narration. The landing app hands uploaded images to the stylist app via postMessage. Backend source was indexed as read but not excerpted, so API implementation detail is limited to documented behavior and visible client routes.

Main entry points: [`Ashar/ai-wardrobe-stylist/App.tsx`](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/App.tsx) (Stylist app), [`server/index.js`](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/server/index.js) (Stylist API), [`Ashar/ai-wardrobe-stylist/components/VoiceStylist.tsx`](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/VoiceStylist.tsx) (Voice stylist), [`src/components/UploadWardrobe.jsx`](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/components/UploadWardrobe.jsx) (Image upload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_landing["Landing and access"]
  node_landing_app["Landing app<br/>[App.jsx]"]
  node_hero["Hero and CTA<br/>[Hero.jsx]"]
  node_auth["Authentication<br/>[main.jsx]"]
  node_features["Feature showcase<br/>[FeaturesPage.jsx]"]
end

subgraph group_wardrobe["Wardrobe intake"]
  node_upload["Image upload<br/>[UploadWardrobe.jsx]"]
  node_browser_store[("Browser image storage")]
  node_uploader["Image uploader<br/>[ImageUploader.tsx]"]
  node_categorization["Clothing categorization<br/>[geminiService.ts]"]
  node_wardrobe_view["Wardrobe gallery<br/>[Wardrobe.tsx]"]
end

subgraph group_styling["Styling experience"]
  node_stylist_app["Stylist app<br/>[App.tsx]"]
  node_outfit_form["Outfit criteria"]
  node_outfit_api["Outfit generation client<br/>[geminiService.ts]"]
  node_suggestions["Outfit suggestions"]
  node_voice_ui["Voice stylist<br/>[VoiceStylist.tsx]"]
end

subgraph group_api["AI services"]
  node_api_server["Stylist API<br/>[index.js]"]
  node_gemini{{"Gemini AI"}}
  node_speech{{"Browser speech"}}
  node_elevenlabs{{"ElevenLabs TTS"}}
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_landing_app
node_landing_app -->|"renders"| node_hero
node_landing_app -->|"opens"| node_features
node_hero -->|"signs in"| node_auth
node_visitor -.->|"selects images"| node_upload
node_features -->|"opens"| node_upload
node_upload -->|"saves images"| node_browser_store
node_upload -->|"posts images"| node_stylist_app
node_stylist_app -->|"categorizes images"| node_categorization
node_categorization -->|"requests categorization"| node_api_server
node_api_server -.->|"uses vision"| node_gemini
node_stylist_app -->|"renders"| node_uploader
node_stylist_app -->|"renders items"| node_wardrobe_view
node_stylist_app -->|"renders"| node_outfit_form
node_outfit_form -.->|"submits criteria"| node_stylist_app
node_stylist_app -->|"requests outfits"| node_outfit_api
node_outfit_api -->|"requests session"| node_api_server
node_api_server -.->|"generates recommendations"| node_gemini
node_stylist_app -->|"renders results"| node_suggestions
node_stylist_app -->|"renders stylist"| node_voice_ui
node_voice_ui -->|"requests stylist session"| node_api_server
node_voice_ui -.->|"recognizes speech"| node_speech
node_voice_ui -->|"requests narration"| node_api_server
node_api_server -.->|"synthesizes speech"| node_elevenlabs

click node_landing_app "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/App.jsx"
click node_hero "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/components/Hero.jsx"
click node_auth "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/main.jsx"
click node_features "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/components/FeaturesPage.jsx"
click node_upload "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/components/UploadWardrobe.jsx"
click node_stylist_app "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/App.tsx"
click node_uploader "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/ImageUploader.tsx"
click node_categorization "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/services/geminiService.ts"
click node_wardrobe_view "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/Wardrobe.tsx"
click node_outfit_form "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/OutfitGenerator.tsx"
click node_outfit_api "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/services/geminiService.ts"
click node_suggestions "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/OutfitSuggestions.tsx"
click node_voice_ui "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/VoiceStylist.tsx"
click node_api_server "https://github.com/ashmitkmishra/hackfashion-ai/blob/main/server/index.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_landing_app,node_hero,node_auth,node_features toneBlue
class node_upload,node_browser_store,node_uploader,node_categorization,node_wardrobe_view toneAmber
class node_stylist_app,node_outfit_form,node_outfit_api,node_suggestions,node_voice_ui toneMint
class node_api_server,node_gemini,node_speech,node_elevenlabs toneRose
class node_visitor toneIndigo
```

## Components

### Landing and access

- [Landing app](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/App.jsx): `src/App.jsx`
- [Hero and CTA](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/components/Hero.jsx): `src/components/Hero.jsx`
- [Authentication](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/main.jsx): `src/main.jsx`
- [Feature showcase](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/components/FeaturesPage.jsx): `src/components/FeaturesPage.jsx`

### Wardrobe intake

- [Image upload](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/src/components/UploadWardrobe.jsx): `src/components/UploadWardrobe.jsx`
- **Browser image storage**
- [Image uploader](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/ImageUploader.tsx): `Ashar/ai-wardrobe-stylist/components/ImageUploader.tsx`
- [Clothing categorization](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/services/geminiService.ts): `Ashar/ai-wardrobe-stylist/services/geminiService.ts`
- [Wardrobe gallery](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/Wardrobe.tsx): `Ashar/ai-wardrobe-stylist/components/Wardrobe.tsx`

### Styling experience

- [Stylist app](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/App.tsx): `Ashar/ai-wardrobe-stylist/App.tsx`
- [Outfit criteria](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/OutfitGenerator.tsx): `Ashar/ai-wardrobe-stylist/components/OutfitGenerator.tsx`
- [Outfit generation client](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/services/geminiService.ts): `Ashar/ai-wardrobe-stylist/services/geminiService.ts`
- [Outfit suggestions](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/OutfitSuggestions.tsx): `Ashar/ai-wardrobe-stylist/components/OutfitSuggestions.tsx`
- [Voice stylist](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/Ashar/ai-wardrobe-stylist/components/VoiceStylist.tsx): `Ashar/ai-wardrobe-stylist/components/VoiceStylist.tsx`

### AI services

- [Stylist API](https://github.com/ashmitkmishra/hackfashion-ai/blob/main/server/index.js): `server/index.js`
- **Gemini AI**
- **Browser speech**
- **ElevenLabs TTS**

### Other components

- **Visitor**

## Connections

- Visitor → Landing app: opens
- Landing app → Hero and CTA: renders (evidence: `src/App.jsx`)
- Landing app → Feature showcase: opens (evidence: `src/App.jsx`)
- Hero and CTA → Authentication: signs in (evidence: `src/components/Hero.jsx`)
- Visitor → Image upload: selects images (evidence: `README.md`)
- Feature showcase → Image upload: opens (evidence: `src/components/FeaturesPage.jsx`)
- Image upload → Browser image storage: saves images (evidence: `src/components/UploadWardrobe.jsx`)
- Image upload → Stylist app: posts images (evidence: `src/components/UploadWardrobe.jsx`)
- Stylist app → Clothing categorization: categorizes images (evidence: `Ashar/ai-wardrobe-stylist/App.tsx`)
- Clothing categorization → Stylist API: requests categorization (evidence: `Ashar/ai-wardrobe-stylist/services/geminiService.ts`)
- Stylist API → Gemini AI: uses vision (evidence: `README.md`)
- Stylist app → Image uploader: renders (evidence: `Ashar/ai-wardrobe-stylist/App.tsx`)
- Stylist app → Wardrobe gallery: renders items (evidence: `Ashar/ai-wardrobe-stylist/App.tsx`)
- Stylist app → Outfit criteria: renders (evidence: `Ashar/ai-wardrobe-stylist/App.tsx`)
- Outfit criteria → Stylist app: submits criteria (evidence: `Ashar/ai-wardrobe-stylist/App.tsx`)
- Stylist app → Outfit generation client: requests outfits (evidence: `Ashar/ai-wardrobe-stylist/App.tsx`)
- Outfit generation client → Stylist API: requests session (evidence: `Ashar/ai-wardrobe-stylist/services/geminiService.ts`)
- Stylist API → Gemini AI: generates recommendations (evidence: `README.md`)
- Stylist app → Outfit suggestions: renders results (evidence: `Ashar/ai-wardrobe-stylist/App.tsx`)
- Stylist app → Voice stylist: renders stylist (evidence: `Ashar/ai-wardrobe-stylist/App.tsx`)
- Voice stylist → Stylist API: requests stylist session (evidence: `README.md`)
- Voice stylist → Browser speech: recognizes speech (evidence: `README.md`)
- Voice stylist → Stylist API: requests narration (evidence: `README.md`)
- Stylist API → ElevenLabs TTS: synthesizes speech (evidence: `README.md`)
