# sreelakshmig-science/vestir architecture

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

- Interactive diagram: https://gitdiagram.com/sreelakshmig-science/vestir
- Repository: https://github.com/sreelakshmig-science/vestir

## Overview

Vestir is an Expo clothing-catalogue and garment try-on demo, with a separate Express/MongoDB backend that is not yet wired to the app. The user journey runs through login or signup, garment browsing, detail, camera-overlay try-on, and favourites; users can also add garments using a camera or photo library. The frontend currently keeps catalogue and favourite state in memory, while the backend exposes corresponding API routes. Edges reflect excerpts, indexed references, or README-documented behavior; the README explicitly describes backend integration as future work.

Main entry points: [`src/navigation/RootNavigator.js`](https://github.com/sreelakshmig-science/vestir/blob/main/src/navigation/RootNavigator.js) (Root navigation), [`src/screens/HomeScreen.js`](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/HomeScreen.js) (Dress catalogue), [`src/screens/LoginScreen.js`](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/LoginScreen.js) (Login), [`src/screens/SignupScreen.js`](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/SignupScreen.js) (Signup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Mobile app"]
  node_app_entry["App providers<br/>[App.js]"]
  node_navigation["Root navigation<br/>[RootNavigator.js]"]
  node_tabs["Main tabs<br/>[MainTabs.js]"]
  node_login["Login<br/>[LoginScreen.js]"]
  node_signup["Signup<br/>[SignupScreen.js]"]
  node_instructions["Instructions"]
end

subgraph group_catalogue["Garment experience"]
  node_home["Dress catalogue<br/>[HomeScreen.js]"]
  node_dress_card["Dress card<br/>[DressCard.js]"]
  node_dress_detail["Dress detail"]
  node_try_on["Camera try-on<br/>[TryOnScreen.js]"]
  node_upload["Dress upload"]
  node_favourites_screen["Favourites"]
  node_dresses_state["Dress state<br/>[DressesContext.js]"]
  node_mock_catalogue["Sample dresses<br/>[mockDresses.js]"]
  node_favourites_state["Favourite state"]
end

subgraph group_shared["Shared UI"]
  node_form_field["Form field<br/>[FormField.js]"]
  node_primary_button["Primary button<br/>[PrimaryButton.js]"]
  node_design_tokens["Design tokens<br/>[tokens.js]"]
end

subgraph group_backend["Backend API"]
  node_api_server["Express server<br/>[server.js]"]
  node_user_routes["User routes<br/>[userRoutes.js]"]
  node_dress_routes["Dress routes<br/>[dressRoutes.js]"]
  node_favourite_routes["Favourite routes<br/>[favouriteRoutes.js]"]
  node_auth["JWT middleware<br/>[Auth.js]"]
end

subgraph group_data["Backend data"]
  node_user_model["User model<br/>[User.js]"]
  node_dress_model["Dress model<br/>[Dress.js]"]
  node_favourite_model["Favourite model<br/>[Favourite.js]"]
end

node_wearer(("Wearer"))
node_mongodb[("MongoDB")]

node_wearer -->|"starts at"| node_login
node_wearer -->|"creates account"| node_signup
node_app_entry -->|"renders"| node_navigation
node_app_entry -->|"provides state"| node_dresses_state
node_app_entry -->|"provides state"| node_favourites_state
node_navigation -->|"routes to"| node_login
node_navigation -->|"routes to"| node_signup
node_navigation -->|"routes to"| node_instructions
node_navigation -->|"routes to"| node_tabs
node_navigation -->|"routes to"| node_dress_detail
node_navigation -->|"routes to"| node_try_on
node_navigation -->|"routes to"| node_upload
node_login -->|"navigates on success"| node_tabs
node_signup -->|"navigates on success"| node_instructions
node_tabs -->|"shows tab"| node_home
node_tabs -->|"shows tab"| node_favourites_screen
node_home -->|"renders"| node_dress_card
node_home -->|"reads catalogue"| node_dresses_state
node_home -->|"opens on selection"| node_dress_detail
node_home -->|"opens upload"| node_upload
node_dress_detail -->|"opens try-on"| node_try_on
node_dress_detail -->|"uses favourites"| node_favourites_state
node_try_on -->|"uses favourites"| node_favourites_state
node_favourites_screen -->|"reads favourites"| node_favourites_state
node_upload -->|"adds dress"| node_dresses_state
node_dresses_state -->|"seeds from"| node_mock_catalogue
node_login -->|"renders"| node_form_field
node_signup -->|"renders"| node_form_field
node_upload -->|"renders"| node_form_field
node_login -->|"renders"| node_primary_button
node_signup -->|"renders"| node_primary_button
node_instructions -->|"renders"| node_primary_button
node_upload -->|"renders"| node_primary_button
node_form_field -->|"uses styles"| node_design_tokens
node_primary_button -->|"uses styles"| node_design_tokens
node_dress_card -->|"uses styles"| node_design_tokens
node_api_server -->|"mounts routes"| node_user_routes
node_api_server -->|"mounts routes"| node_dress_routes
node_api_server -->|"mounts routes"| node_favourite_routes
node_api_server -->|"connects to"| node_mongodb
node_user_routes -->|"queries"| node_user_model
node_user_routes -->|"protects profile"| node_auth
node_dress_routes -->|"reads and writes"| node_dress_model
node_favourite_routes -->|"reads and writes"| node_favourite_model
node_favourite_routes -->|"protects routes"| node_auth

click node_app_entry "https://github.com/sreelakshmig-science/vestir/blob/main/App.js"
click node_navigation "https://github.com/sreelakshmig-science/vestir/blob/main/src/navigation/RootNavigator.js"
click node_tabs "https://github.com/sreelakshmig-science/vestir/blob/main/src/navigation/MainTabs.js"
click node_login "https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/LoginScreen.js"
click node_signup "https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/SignupScreen.js"
click node_instructions "https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/InstructionsScreen.js"
click node_home "https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/HomeScreen.js"
click node_dress_card "https://github.com/sreelakshmig-science/vestir/blob/main/src/components/DressCard.js"
click node_dress_detail "https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/DressDetailScreen.js"
click node_try_on "https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/TryOnScreen.js"
click node_upload "https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/UploadDressScreen.js"
click node_favourites_screen "https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/FavouritesScreen.js"
click node_dresses_state "https://github.com/sreelakshmig-science/vestir/blob/main/src/context/DressesContext.js"
click node_mock_catalogue "https://github.com/sreelakshmig-science/vestir/blob/main/src/data/mockDresses.js"
click node_favourites_state "https://github.com/sreelakshmig-science/vestir/blob/main/src/context/FavouritesContext.js"
click node_form_field "https://github.com/sreelakshmig-science/vestir/blob/main/src/components/FormField.js"
click node_primary_button "https://github.com/sreelakshmig-science/vestir/blob/main/src/components/PrimaryButton.js"
click node_design_tokens "https://github.com/sreelakshmig-science/vestir/blob/main/src/theme/tokens.js"
click node_api_server "https://github.com/sreelakshmig-science/vestir/blob/main/backend/server.js"
click node_user_routes "https://github.com/sreelakshmig-science/vestir/blob/main/backend/routes/userRoutes.js"
click node_dress_routes "https://github.com/sreelakshmig-science/vestir/blob/main/backend/routes/dressRoutes.js"
click node_favourite_routes "https://github.com/sreelakshmig-science/vestir/blob/main/backend/routes/favouriteRoutes.js"
click node_auth "https://github.com/sreelakshmig-science/vestir/blob/main/backend/middleware/Auth.js"
click node_user_model "https://github.com/sreelakshmig-science/vestir/blob/main/backend/models/User.js"
click node_dress_model "https://github.com/sreelakshmig-science/vestir/blob/main/backend/models/Dress.js"
click node_favourite_model "https://github.com/sreelakshmig-science/vestir/blob/main/backend/models/Favourite.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_app_entry,node_navigation,node_tabs,node_login,node_signup,node_instructions toneBlue
class node_home,node_dress_card,node_dress_detail,node_try_on,node_upload,node_favourites_screen,node_dresses_state,node_mock_catalogue,node_favourites_state,node_mongodb toneAmber
class node_form_field,node_primary_button,node_design_tokens toneMint
class node_api_server,node_user_routes,node_dress_routes,node_favourite_routes,node_auth toneRose
class node_user_model,node_dress_model,node_favourite_model,node_wearer toneIndigo
```

## Components

### Mobile app

- [App providers](https://github.com/sreelakshmig-science/vestir/blob/main/App.js): `App.js`
- [Root navigation](https://github.com/sreelakshmig-science/vestir/blob/main/src/navigation/RootNavigator.js): `src/navigation/RootNavigator.js`
- [Main tabs](https://github.com/sreelakshmig-science/vestir/blob/main/src/navigation/MainTabs.js): `src/navigation/MainTabs.js`
- [Login](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/LoginScreen.js): `src/screens/LoginScreen.js`
- [Signup](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/SignupScreen.js): `src/screens/SignupScreen.js`
- [Instructions](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/InstructionsScreen.js): `src/screens/InstructionsScreen.js`

### Garment experience

- [Dress catalogue](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/HomeScreen.js): `src/screens/HomeScreen.js`
- [Dress card](https://github.com/sreelakshmig-science/vestir/blob/main/src/components/DressCard.js): `src/components/DressCard.js`
- [Dress detail](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/DressDetailScreen.js): `src/screens/DressDetailScreen.js`
- [Camera try-on](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/TryOnScreen.js): `src/screens/TryOnScreen.js`
- [Dress upload](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/UploadDressScreen.js): `src/screens/UploadDressScreen.js`
- [Favourites](https://github.com/sreelakshmig-science/vestir/blob/main/src/screens/FavouritesScreen.js): `src/screens/FavouritesScreen.js`
- [Dress state](https://github.com/sreelakshmig-science/vestir/blob/main/src/context/DressesContext.js): `src/context/DressesContext.js`
- [Sample dresses](https://github.com/sreelakshmig-science/vestir/blob/main/src/data/mockDresses.js): `src/data/mockDresses.js`
- [Favourite state](https://github.com/sreelakshmig-science/vestir/blob/main/src/context/FavouritesContext.js): `src/context/FavouritesContext.js`

### Shared UI

- [Form field](https://github.com/sreelakshmig-science/vestir/blob/main/src/components/FormField.js): `src/components/FormField.js`
- [Primary button](https://github.com/sreelakshmig-science/vestir/blob/main/src/components/PrimaryButton.js): `src/components/PrimaryButton.js`
- [Design tokens](https://github.com/sreelakshmig-science/vestir/blob/main/src/theme/tokens.js): `src/theme/tokens.js`

### Backend API

- [Express server](https://github.com/sreelakshmig-science/vestir/blob/main/backend/server.js): `backend/server.js`
- [User routes](https://github.com/sreelakshmig-science/vestir/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [Dress routes](https://github.com/sreelakshmig-science/vestir/blob/main/backend/routes/dressRoutes.js): `backend/routes/dressRoutes.js`
- [Favourite routes](https://github.com/sreelakshmig-science/vestir/blob/main/backend/routes/favouriteRoutes.js): `backend/routes/favouriteRoutes.js`
- [JWT middleware](https://github.com/sreelakshmig-science/vestir/blob/main/backend/middleware/Auth.js): `backend/middleware/Auth.js`

### Backend data

- [User model](https://github.com/sreelakshmig-science/vestir/blob/main/backend/models/User.js): `backend/models/User.js`
- [Dress model](https://github.com/sreelakshmig-science/vestir/blob/main/backend/models/Dress.js): `backend/models/Dress.js`
- [Favourite model](https://github.com/sreelakshmig-science/vestir/blob/main/backend/models/Favourite.js): `backend/models/Favourite.js`

### Other components

- **Wearer**
- **MongoDB**

## Connections

- Wearer → Login: starts at (evidence: `README.md`)
- Wearer → Signup: creates account (evidence: `README.md`)
- App providers → Root navigation: renders (evidence: `App.js`)
- App providers → Dress state: provides state (evidence: `App.js`)
- App providers → Favourite state: provides state (evidence: `App.js`)
- Root navigation → Login: routes to (evidence: `src/navigation/RootNavigator.js`)
- Root navigation → Signup: routes to (evidence: `src/navigation/RootNavigator.js`)
- Root navigation → Instructions: routes to (evidence: `src/navigation/RootNavigator.js`)
- Root navigation → Main tabs: routes to (evidence: `src/navigation/RootNavigator.js`)
- Root navigation → Dress detail: routes to (evidence: `src/navigation/RootNavigator.js`)
- Root navigation → Camera try-on: routes to (evidence: `src/navigation/RootNavigator.js`)
- Root navigation → Dress upload: routes to (evidence: `src/navigation/RootNavigator.js`)
- Login → Main tabs: navigates on success (evidence: `README.md`)
- Signup → Instructions: navigates on success (evidence: `README.md`)
- Main tabs → Dress catalogue: shows tab (evidence: `src/navigation/MainTabs.js`)
- Main tabs → Favourites: shows tab (evidence: `src/navigation/MainTabs.js`)
- Dress catalogue → Dress card: renders (evidence: `src/screens/HomeScreen.js`)
- Dress catalogue → Dress state: reads catalogue (evidence: `src/screens/HomeScreen.js`)
- Dress catalogue → Dress detail: opens on selection (evidence: `README.md`)
- Dress catalogue → Dress upload: opens upload (evidence: `README.md`)
- Dress detail → Camera try-on: opens try-on (evidence: `README.md`)
- Dress detail → Favourite state: uses favourites (evidence: `src/screens/DressDetailScreen.js`)
- Camera try-on → Favourite state: uses favourites (evidence: `src/screens/TryOnScreen.js`)
- Favourites → Favourite state: reads favourites (evidence: `src/screens/FavouritesScreen.js`)
- Dress upload → Dress state: adds dress (evidence: `src/screens/UploadDressScreen.js`)
- Dress state → Sample dresses: seeds from (evidence: `src/context/DressesContext.js`)
- Login → Form field: renders (evidence: `src/screens/LoginScreen.js`)
- Signup → Form field: renders (evidence: `src/screens/SignupScreen.js`)
- Dress upload → Form field: renders (evidence: `src/screens/UploadDressScreen.js`)
- Login → Primary button: renders (evidence: `src/screens/LoginScreen.js`)
- Signup → Primary button: renders (evidence: `src/screens/SignupScreen.js`)
- Instructions → Primary button: renders (evidence: `src/screens/InstructionsScreen.js`)
- Dress upload → Primary button: renders (evidence: `src/screens/UploadDressScreen.js`)
- Form field → Design tokens: uses styles (evidence: `src/components/FormField.js`)
- Primary button → Design tokens: uses styles (evidence: `src/components/PrimaryButton.js`)
- Dress card → Design tokens: uses styles (evidence: `src/components/DressCard.js`)
- Express server → User routes: mounts routes (evidence: `backend/server.js`)
- Express server → Dress routes: mounts routes (evidence: `backend/server.js`)
- Express server → Favourite routes: mounts routes (evidence: `backend/server.js`)
- Express server → MongoDB: connects to (evidence: `backend/server.js`)
- User routes → User model: queries (evidence: `backend/routes/userRoutes.js`)
- User routes → JWT middleware: protects profile (evidence: `backend/routes/userRoutes.js`)
- Dress routes → Dress model: reads and writes (evidence: `backend/routes/dressRoutes.js`)
- Favourite routes → Favourite model: reads and writes (evidence: `backend/routes/favouriteRoutes.js`)
- Favourite routes → JWT middleware: protects routes (evidence: `backend/routes/favouriteRoutes.js`)
