# divyakrish-007/flair-finds architecture

> Architecture diagram of the GitHub repository divyakrish-007/flair-finds, 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/divyakrish-007/flair-finds
- Repository: https://github.com/divyakrish-007/flair-finds

## Overview

Flair Finds is a fashion e-commerce application whose main journey runs from product discovery and product detail through cart and simulated checkout to order history. The React client also provides authentication, wishlist, reviews, AI styling and outfit building, plus admin management; an Express API serves these capabilities over a file-backed database. The graph preserves the documented feature areas, but some frontend and backend relationships are represented only where the excerpts, source index, or README support them; unsampled implementation details are not inferred.

Main entry points: [`src/services/api.ts`](https://github.com/divyakrish-007/flair-finds/blob/main/src/services/api.ts) (API Client), [`src/App.tsx`](https://github.com/divyakrish-007/flair-finds/blob/main/src/App.tsx) (App Router), [`server/src/index.ts`](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/index.ts) (Express API), [`src/pages/Shop.tsx`](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Shop.tsx) (Catalog Search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["App Router<br/>[App.tsx]"]
  node_home["Home Discovery<br/>[Home.tsx]"]
  node_shop["Catalog Search<br/>[Shop.tsx]"]
  node_filters["Faceted Filters<br/>[FilterSidebar.tsx]"]
  node_product["Product Detail<br/>[ProductDetail.tsx]"]
  node_productcard["Product Cards<br/>[ProductCard.tsx]"]
end

subgraph group_customer["Customer Features"]
  node_auth["Authentication State<br/>[AuthContext.tsx]"]
  node_cartstate["Cart State<br/>[CartContext.tsx]"]
  node_wishliststate["Wishlist State"]
  node_checkout["Checkout<br/>[Checkout.tsx]"]
  node_orderspage["Order History<br/>[Orders.tsx]"]
  node_reviewsui["Customer Reviews<br/>[ReviewSection.tsx]"]
  node_aichat["AI Chatbot<br/>[AIChatbot.tsx]"]
  node_aipage["AI Fashion Studio"]
  node_outfit["Outfit Builder"]
end

subgraph group_admin["Administration"]
  node_adminstats["Admin Analytics<br/>[AdminDashboard.tsx]"]
  node_adminproducts["Product Management<br/>[AdminProducts.tsx]"]
  node_adminorders["Order Management<br/>[AdminOrders.tsx]"]
  node_adminusers["User Management<br/>[AdminUsers.tsx]"]
  node_adminreviews["Review Moderation<br/>[AdminReviews.tsx]"]
end

subgraph group_backend["API and Data"]
  node_api["API Client<br/>[api.ts]"]
  node_server["Express API<br/>[index.ts]"]
  node_authroutes["Auth Routes<br/>[auth.ts]"]
  node_productroutes["Product Routes<br/>[products.ts]"]
  node_cartroutes["Cart Routes<br/>[cart.ts]"]
  node_wishroutes["Wishlist Routes<br/>[wishlist.ts]"]
  node_orderroutes["Order Routes<br/>[orders.ts]"]
  node_reviewroutes["Review Routes<br/>[reviews.ts]"]
  node_adminroutes["Admin Routes<br/>[admin.ts]"]
  node_airoutes["AI Routes<br/>[ai.ts]"]
  node_authmw["JWT Authorization<br/>[auth.ts]"]
  node_seed["Seed Catalog<br/>[seed.ts]"]
  node_database[("File-backed Database<br/>[database.ts]")]
end

node_shopper(("Shopper"))

node_shopper -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_shop
node_app -->|"routes to"| node_product
node_shopper -->|"searches and filters"| node_shop
node_shop -->|"renders"| node_filters
node_shop -->|"renders"| node_productcard
node_home -->|"renders"| node_productcard
node_product -->|"renders"| node_productcard
node_shopper -->|"selects item"| node_product
node_product -->|"requests product"| node_api
node_shop -->|"requests catalog"| node_api
node_app -->|"provides state"| node_auth
node_app -->|"provides state"| node_cartstate
node_app -->|"provides state"| node_wishliststate
node_productcard -->|"adds to cart"| node_cartstate
node_productcard -->|"toggles saved item"| node_wishliststate
node_wishliststate -->|"moves item"| node_cartstate
node_cartstate -->|"syncs cart"| node_api
node_wishliststate -->|"syncs wishlist"| node_api
node_shopper -->|"checks out"| node_checkout
node_checkout -->|"reads cart"| node_cartstate
node_checkout -->|"submits order"| node_api
node_orderspage -->|"loads orders"| node_api
node_product -->|"renders reviews"| node_reviewsui
node_reviewsui -->|"submits review"| node_api
node_app -->|"mounts widget"| node_aichat
node_app -->|"routes to"| node_aipage
node_app -->|"opens builder"| node_outfit
node_aichat -->|"requests styling"| node_api
node_aipage -->|"requests styling"| node_api
node_outfit -->|"requests outfit"| node_api
node_adminstats -->|"loads analytics"| node_api
node_adminproducts -->|"manages products"| node_api
node_adminorders -->|"updates orders"| node_api
node_adminusers -->|"loads users"| node_api
node_adminreviews -->|"moderates reviews"| node_api
node_api -->|"calls API"| node_server
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_productroutes
node_server -->|"mounts routes"| node_cartroutes
node_server -->|"mounts routes"| node_wishroutes
node_server -->|"mounts routes"| node_orderroutes
node_server -->|"mounts routes"| node_reviewroutes
node_server -->|"mounts routes"| node_adminroutes
node_server -->|"mounts routes"| node_airoutes
node_authroutes -->|"reads and writes"| node_database
node_productroutes -->|"reads catalog"| node_database

click node_app "https://github.com/divyakrish-007/flair-finds/blob/main/src/App.tsx"
click node_home "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Home.tsx"
click node_shop "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Shop.tsx"
click node_filters "https://github.com/divyakrish-007/flair-finds/blob/main/src/components/FilterSidebar.tsx"
click node_product "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/ProductDetail.tsx"
click node_productcard "https://github.com/divyakrish-007/flair-finds/blob/main/src/components/ProductCard.tsx"
click node_auth "https://github.com/divyakrish-007/flair-finds/blob/main/src/context/AuthContext.tsx"
click node_cartstate "https://github.com/divyakrish-007/flair-finds/blob/main/src/context/CartContext.tsx"
click node_wishliststate "https://github.com/divyakrish-007/flair-finds/blob/main/src/context/WishlistContext.tsx"
click node_checkout "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Checkout.tsx"
click node_orderspage "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Orders.tsx"
click node_reviewsui "https://github.com/divyakrish-007/flair-finds/blob/main/src/components/ReviewSection.tsx"
click node_aichat "https://github.com/divyakrish-007/flair-finds/blob/main/src/components/AIChatbot.tsx"
click node_aipage "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/AIAssistantPage.tsx"
click node_outfit "https://github.com/divyakrish-007/flair-finds/blob/main/src/components/OutfitBuilderModal.tsx"
click node_adminstats "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminDashboard.tsx"
click node_adminproducts "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminProducts.tsx"
click node_adminorders "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminOrders.tsx"
click node_adminusers "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminUsers.tsx"
click node_adminreviews "https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminReviews.tsx"
click node_api "https://github.com/divyakrish-007/flair-finds/blob/main/src/services/api.ts"
click node_server "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/index.ts"
click node_authroutes "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/auth.ts"
click node_productroutes "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/products.ts"
click node_cartroutes "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/cart.ts"
click node_wishroutes "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/wishlist.ts"
click node_orderroutes "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/orders.ts"
click node_reviewroutes "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/reviews.ts"
click node_adminroutes "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/admin.ts"
click node_airoutes "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/ai.ts"
click node_authmw "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/middleware/auth.ts"
click node_seed "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/db/seed.ts"
click node_database "https://github.com/divyakrish-007/flair-finds/blob/main/server/src/db/database.ts"

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_home,node_shop,node_filters,node_product,node_productcard toneBlue
class node_auth,node_cartstate,node_wishliststate,node_checkout,node_orderspage,node_reviewsui,node_aichat,node_aipage,node_outfit toneAmber
class node_adminstats,node_adminproducts,node_adminorders,node_adminusers,node_adminreviews toneMint
class node_api,node_server,node_authroutes,node_productroutes,node_cartroutes,node_wishroutes,node_orderroutes,node_reviewroutes,node_adminroutes,node_airoutes,node_authmw,node_seed,node_database toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [App Router](https://github.com/divyakrish-007/flair-finds/blob/main/src/App.tsx): `src/App.tsx`
- [Home Discovery](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Catalog Search](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Shop.tsx): `src/pages/Shop.tsx`
- [Faceted Filters](https://github.com/divyakrish-007/flair-finds/blob/main/src/components/FilterSidebar.tsx): `src/components/FilterSidebar.tsx`
- [Product Detail](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/ProductDetail.tsx): `src/pages/ProductDetail.tsx`
- [Product Cards](https://github.com/divyakrish-007/flair-finds/blob/main/src/components/ProductCard.tsx): `src/components/ProductCard.tsx`

### Customer Features

- [Authentication State](https://github.com/divyakrish-007/flair-finds/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Cart State](https://github.com/divyakrish-007/flair-finds/blob/main/src/context/CartContext.tsx): `src/context/CartContext.tsx`
- [Wishlist State](https://github.com/divyakrish-007/flair-finds/blob/main/src/context/WishlistContext.tsx): `src/context/WishlistContext.tsx`
- [Checkout](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Checkout.tsx): `src/pages/Checkout.tsx`
- [Order History](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/Orders.tsx): `src/pages/Orders.tsx`
- [Customer Reviews](https://github.com/divyakrish-007/flair-finds/blob/main/src/components/ReviewSection.tsx): `src/components/ReviewSection.tsx`
- [AI Chatbot](https://github.com/divyakrish-007/flair-finds/blob/main/src/components/AIChatbot.tsx): `src/components/AIChatbot.tsx`
- [AI Fashion Studio](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/AIAssistantPage.tsx): `src/pages/AIAssistantPage.tsx`
- [Outfit Builder](https://github.com/divyakrish-007/flair-finds/blob/main/src/components/OutfitBuilderModal.tsx): `src/components/OutfitBuilderModal.tsx`

### Administration

- [Admin Analytics](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminDashboard.tsx): `src/pages/admin/AdminDashboard.tsx`
- [Product Management](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminProducts.tsx): `src/pages/admin/AdminProducts.tsx`
- [Order Management](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminOrders.tsx): `src/pages/admin/AdminOrders.tsx`
- [User Management](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminUsers.tsx): `src/pages/admin/AdminUsers.tsx`
- [Review Moderation](https://github.com/divyakrish-007/flair-finds/blob/main/src/pages/admin/AdminReviews.tsx): `src/pages/admin/AdminReviews.tsx`

### API and Data

- [API Client](https://github.com/divyakrish-007/flair-finds/blob/main/src/services/api.ts): `src/services/api.ts`
- [Express API](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/index.ts): `server/src/index.ts`
- [Auth Routes](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/auth.ts): `server/src/routes/auth.ts`
- [Product Routes](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/products.ts): `server/src/routes/products.ts`
- [Cart Routes](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/cart.ts): `server/src/routes/cart.ts`
- [Wishlist Routes](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/wishlist.ts): `server/src/routes/wishlist.ts`
- [Order Routes](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/orders.ts): `server/src/routes/orders.ts`
- [Review Routes](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/reviews.ts): `server/src/routes/reviews.ts`
- [Admin Routes](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/admin.ts): `server/src/routes/admin.ts`
- [AI Routes](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/routes/ai.ts): `server/src/routes/ai.ts`
- [JWT Authorization](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/middleware/auth.ts): `server/src/middleware/auth.ts`
- [Seed Catalog](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/db/seed.ts): `server/src/db/seed.ts`
- [File-backed Database](https://github.com/divyakrish-007/flair-finds/blob/main/server/src/db/database.ts): `server/src/db/database.ts`

### Other components

- **Shopper**

## Connections

- Shopper → App Router: opens (evidence: `README.md`)
- App Router → Home Discovery: routes to (evidence: `src/App.tsx`)
- App Router → Catalog Search: routes to (evidence: `src/App.tsx`)
- App Router → Product Detail: routes to (evidence: `src/App.tsx`)
- Shopper → Catalog Search: searches and filters (evidence: `README.md`)
- Catalog Search → Faceted Filters: renders (evidence: `src/pages/Shop.tsx`)
- Catalog Search → Product Cards: renders (evidence: `src/pages/Shop.tsx`)
- Home Discovery → Product Cards: renders (evidence: `src/pages/Home.tsx`)
- Product Detail → Product Cards: renders (evidence: `src/pages/ProductDetail.tsx`)
- Shopper → Product Detail: selects item (evidence: `README.md`)
- Product Detail → API Client: requests product (evidence: `src/pages/ProductDetail.tsx`)
- Catalog Search → API Client: requests catalog (evidence: `src/pages/Shop.tsx`)
- App Router → Authentication State: provides state (evidence: `src/App.tsx`)
- App Router → Cart State: provides state (evidence: `src/App.tsx`)
- App Router → Wishlist State: provides state (evidence: `src/App.tsx`)
- Product Cards → Cart State: adds to cart (evidence: `src/components/ProductCard.tsx`)
- Product Cards → Wishlist State: toggles saved item (evidence: `src/components/ProductCard.tsx`)
- Wishlist State → Cart State: moves item (evidence: `src/context/WishlistContext.tsx`)
- Cart State → API Client: syncs cart (evidence: `src/context/CartContext.tsx`)
- Wishlist State → API Client: syncs wishlist (evidence: `src/context/WishlistContext.tsx`)
- Shopper → Checkout: checks out (evidence: `README.md`)
- Checkout → Cart State: reads cart (evidence: `src/pages/Checkout.tsx`)
- Checkout → API Client: submits order (evidence: `src/pages/Checkout.tsx`)
- Order History → API Client: loads orders (evidence: `README.md`)
- Product Detail → Customer Reviews: renders reviews (evidence: `src/pages/ProductDetail.tsx`)
- Customer Reviews → API Client: submits review (evidence: `src/components/ReviewSection.tsx`)
- App Router → AI Chatbot: mounts widget (evidence: `src/App.tsx`)
- App Router → AI Fashion Studio: routes to (evidence: `src/App.tsx`)
- App Router → Outfit Builder: opens builder (evidence: `src/App.tsx`)
- AI Chatbot → API Client: requests styling (evidence: `src/components/AIChatbot.tsx`)
- AI Fashion Studio → API Client: requests styling (evidence: `src/pages/AIAssistantPage.tsx`)
- Outfit Builder → API Client: requests outfit (evidence: `src/components/OutfitBuilderModal.tsx`)
- Admin Analytics → API Client: loads analytics (evidence: `src/pages/admin/AdminDashboard.tsx`)
- Product Management → API Client: manages products (evidence: `src/pages/admin/AdminProducts.tsx`)
- Order Management → API Client: updates orders (evidence: `src/pages/admin/AdminOrders.tsx`)
- User Management → API Client: loads users (evidence: `src/pages/admin/AdminUsers.tsx`)
- Review Moderation → API Client: moderates reviews (evidence: `src/pages/admin/AdminReviews.tsx`)
- API Client → Express API: calls API (evidence: `README.md`)
- Express API → Auth Routes: mounts routes (evidence: `server/src/index.ts`)
- Express API → Product Routes: mounts routes (evidence: `server/src/index.ts`)
- Express API → Cart Routes: mounts routes (evidence: `server/src/index.ts`)
- Express API → Wishlist Routes: mounts routes (evidence: `server/src/index.ts`)
- Express API → Order Routes: mounts routes (evidence: `server/src/index.ts`)
- Express API → Review Routes: mounts routes (evidence: `server/src/index.ts`)
- Express API → Admin Routes: mounts routes (evidence: `server/src/index.ts`)
- Express API → AI Routes: mounts routes (evidence: `server/src/index.ts`)
- Auth Routes → File-backed Database: reads and writes (evidence: `server/src/routes/auth.ts`)
- Product Routes → File-backed Database: reads catalog (evidence: `server/src/routes/products.ts`)
