# agusarik/ecommerce-dsw-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/agusarik/ecommerce-dsw-frontend
- Repository: https://github.com/agusarik/ecommerce-dsw-frontend

## Overview

This is a React frontend for browsing and purchasing furniture, backed by an HTTP API at the configured backend. The main user flow routes from the shared app shell to the home/catalog and furniture detail views, then uses cart and favorites state; account, order, and login pages provide supporting flows. Admin screens create and edit catalog data. Edges are limited to routing, imports and calls visible in the supplied excerpts or SOURCE INDEX; unsampled page behavior is not inferred.

Main entry points: [`src/App.tsx`](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/App.tsx) (App router), [`src/api/axiosInstance.tsx`](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/api/axiosInstance.tsx) (Axios client), [`src/components/FavoriteButton.tsx`](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/FavoriteButton.tsx) (Favorite button), [`src/components/productoshome.tsx`](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/productoshome.tsx) (Featured furniture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and discovery"]
  node_app_shell["App router<br/>[App.tsx]"]
  node_home["Home<br/>[home.tsx]"]
  node_carousel["Home carousel<br/>[carrusell.tsx]"]
  node_featured["Featured furniture<br/>[productoshome.tsx]"]
  node_header["Header<br/>[header.tsx]"]
  node_search_bar["Search bar<br/>[SearchBar.tsx]"]
  node_catalog["Furniture catalog<br/>[muebles.tsx]"]
  node_search_results["Search results<br/>[buscador.tsx]"]
  node_detail["Furniture detail<br/>[muebleDetail.tsx]"]
end

subgraph group_commerce["Shopping and state"]
  node_cart_page["Cart page<br/>[carrito.tsx]"]
  node_cart_state["Cart state<br/>[carritoContext.tsx]"]
  node_favorites_page["Favorites page<br/>[favoritos.tsx]"]
  node_favorite_button["Favorite button<br/>[FavoriteButton.tsx]"]
  node_favorites_state["Favorites state"]
end

subgraph group_accounts["Accounts and orders"]
  node_login["Login<br/>[login.tsx]"]
  node_profile["Profile<br/>[perfil.tsx]"]
  node_orders["My orders<br/>[misPedidos.tsx]"]
  node_customers["Customers<br/>[clientes.tsx]"]
end

subgraph group_catalog_admin["Catalog administration"]
  node_admin_create["Create catalog<br/>[adminCrear.tsx]"]
end

subgraph group_shared["Shared services"]
  node_api_client["Axios client<br/>[axiosInstance.tsx]"]
  node_currency["Currency formatter<br/>[formatCurrency.ts]"]
  node_types["Domain types<br/>[types.tsx]"]
  node_footer["Footer<br/>[footer.tsx]"]
end

node_shopper(("Shopper"))
node_backend["Backend API"]

node_shopper -->|"uses"| node_app_shell
node_app_shell -->|"routes"| node_home
node_app_shell -->|"routes"| node_catalog
node_app_shell -->|"routes"| node_search_results
node_app_shell -->|"routes"| node_detail
node_app_shell -->|"routes"| node_cart_page
node_app_shell -->|"routes"| node_favorites_page
node_app_shell -->|"routes"| node_login
node_app_shell -->|"routes"| node_profile
node_app_shell -->|"routes"| node_orders
node_app_shell -->|"routes"| node_customers
node_app_shell -->|"routes"| node_admin_create
node_app_shell -->|"renders"| node_header
node_app_shell -->|"renders"| node_footer
node_home -->|"renders"| node_carousel
node_home -->|"renders"| node_featured
node_header -->|"renders"| node_search_bar
node_featured -->|"fetches furniture"| node_api_client
node_catalog -->|"fetches furniture"| node_api_client
node_search_results -->|"searches furniture"| node_api_client
node_detail -->|"loads and edits"| node_api_client
node_admin_create -->|"creates catalog data"| node_api_client
node_login -->|"authenticates"| node_api_client
node_profile -->|"loads profile"| node_api_client
node_orders -->|"loads orders"| node_api_client
node_customers -->|"loads customers"| node_api_client
node_favorites_state -->|"loads and updates"| node_api_client
node_api_client -->|"sends HTTP requests"| node_backend
node_featured -->|"adds item"| node_cart_state
node_detail -->|"adds item"| node_cart_state
node_cart_page -->|"uses cart"| node_cart_state
node_header -->|"reads cart"| node_cart_state
node_cart_page -->|"formats prices"| node_currency
node_orders -->|"formats prices"| node_currency
node_catalog -->|"formats prices"| node_currency
node_search_results -->|"formats prices"| node_currency
node_detail -->|"formats prices"| node_currency
node_featured -->|"renders"| node_favorite_button
node_catalog -->|"renders"| node_favorite_button
node_search_results -->|"renders"| node_favorite_button
node_detail -->|"renders"| node_favorite_button
node_favorites_page -->|"renders"| node_favorite_button
node_favorite_button -->|"toggles favorite"| node_favorites_state
node_favorites_page -->|"reads favorites"| node_favorites_state
node_featured -->|"uses furniture types"| node_types
node_cart_state -->|"uses cart types"| node_types
node_favorites_state -->|"uses furniture types"| node_types

click node_app_shell "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/App.tsx"
click node_home "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/home.tsx"
click node_carousel "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/carrusell.tsx"
click node_featured "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/productoshome.tsx"
click node_header "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/header.tsx"
click node_search_bar "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/SearchBar.tsx"
click node_catalog "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/muebles.tsx"
click node_search_results "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/buscador.tsx"
click node_detail "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/muebleDetail.tsx"
click node_cart_page "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/carrito.tsx"
click node_cart_state "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/context/carritoContext.tsx"
click node_favorites_page "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/favoritos.tsx"
click node_favorite_button "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/FavoriteButton.tsx"
click node_favorites_state "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/context/favoritosContext.tsx"
click node_login "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/login.tsx"
click node_profile "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/perfil.tsx"
click node_orders "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/misPedidos.tsx"
click node_customers "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/clientes.tsx"
click node_admin_create "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/adminCrear.tsx"
click node_api_client "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/api/axiosInstance.tsx"
click node_currency "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/utils/formatCurrency.ts"
click node_types "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/types.tsx"
click node_footer "https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/footer.tsx"

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_shell,node_home,node_carousel,node_featured,node_header,node_search_bar,node_catalog,node_search_results,node_detail toneBlue
class node_cart_page,node_cart_state,node_favorites_page,node_favorite_button,node_favorites_state toneAmber
class node_login,node_profile,node_orders,node_customers,node_backend toneMint
class node_admin_create toneRose
class node_api_client,node_currency,node_types,node_footer,node_shopper toneIndigo
```

## Components

### App and discovery

- [App router](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/App.tsx): `src/App.tsx`
- [Home](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/home.tsx): `src/pages/home.tsx`
- [Home carousel](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/carrusell.tsx): `src/components/carrusell.tsx`
- [Featured furniture](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/productoshome.tsx): `src/components/productoshome.tsx`
- [Header](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/header.tsx): `src/components/header.tsx`
- [Search bar](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/SearchBar.tsx): `src/components/SearchBar.tsx`
- [Furniture catalog](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/muebles.tsx): `src/pages/muebles.tsx`
- [Search results](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/buscador.tsx): `src/pages/buscador.tsx`
- [Furniture detail](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/muebleDetail.tsx): `src/pages/muebleDetail.tsx`

### Shopping and state

- [Cart page](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/carrito.tsx): `src/pages/carrito.tsx`
- [Cart state](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/context/carritoContext.tsx): `src/context/carritoContext.tsx`
- [Favorites page](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/favoritos.tsx): `src/pages/favoritos.tsx`
- [Favorite button](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/FavoriteButton.tsx): `src/components/FavoriteButton.tsx`
- [Favorites state](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/context/favoritosContext.tsx): `src/context/favoritosContext.tsx`

### Accounts and orders

- [Login](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/login.tsx): `src/pages/login.tsx`
- [Profile](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/perfil.tsx): `src/pages/perfil.tsx`
- [My orders](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/misPedidos.tsx): `src/pages/misPedidos.tsx`
- [Customers](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/clientes.tsx): `src/pages/clientes.tsx`

### Catalog administration

- [Create catalog](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/pages/adminCrear.tsx): `src/pages/adminCrear.tsx`

### Shared services

- [Axios client](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/api/axiosInstance.tsx): `src/api/axiosInstance.tsx`
- [Currency formatter](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/utils/formatCurrency.ts): `src/utils/formatCurrency.ts`
- [Domain types](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/types.tsx): `src/types.tsx`
- [Footer](https://github.com/agusarik/ecommerce-dsw-frontend/blob/main/src/components/footer.tsx): `src/components/footer.tsx`

### Other components

- **Shopper**
- **Backend API**

## Connections

- Shopper → App router: uses (evidence: `src/App.tsx`)
- App router → Home: routes (evidence: `src/App.tsx`)
- App router → Furniture catalog: routes (evidence: `src/App.tsx`)
- App router → Search results: routes (evidence: `src/App.tsx`)
- App router → Furniture detail: routes (evidence: `src/App.tsx`)
- App router → Cart page: routes (evidence: `src/App.tsx`)
- App router → Favorites page: routes (evidence: `src/App.tsx`)
- App router → Login: routes (evidence: `src/App.tsx`)
- App router → Profile: routes (evidence: `src/App.tsx`)
- App router → My orders: routes (evidence: `src/App.tsx`)
- App router → Customers: routes (evidence: `src/App.tsx`)
- App router → Create catalog: routes (evidence: `src/App.tsx`)
- App router → Header: renders (evidence: `src/App.tsx`)
- App router → Footer: renders (evidence: `src/App.tsx`)
- Home → Home carousel: renders (evidence: `src/pages/home.tsx`)
- Home → Featured furniture: renders (evidence: `src/pages/home.tsx`)
- Header → Search bar: renders (evidence: `src/components/header.tsx`)
- Featured furniture → Axios client: fetches furniture (evidence: `src/components/productoshome.tsx`)
- Furniture catalog → Axios client: fetches furniture (evidence: `src/pages/muebles.tsx`)
- Search results → Axios client: searches furniture (evidence: `src/pages/buscador.tsx`)
- Furniture detail → Axios client: loads and edits (evidence: `src/pages/muebleDetail.tsx`)
- Create catalog → Axios client: creates catalog data (evidence: `src/pages/adminCrear.tsx`)
- Login → Axios client: authenticates (evidence: `src/pages/login.tsx`)
- Profile → Axios client: loads profile (evidence: `src/pages/perfil.tsx`)
- My orders → Axios client: loads orders (evidence: `src/pages/misPedidos.tsx`)
- Customers → Axios client: loads customers (evidence: `src/pages/clientes.tsx`)
- Favorites state → Axios client: loads and updates (evidence: `src/context/favoritosContext.tsx`)
- Axios client → Backend API: sends HTTP requests (evidence: `src/api/axiosInstance.tsx`)
- Featured furniture → Cart state: adds item (evidence: `src/components/productoshome.tsx`)
- Furniture detail → Cart state: adds item (evidence: `src/pages/muebleDetail.tsx`)
- Cart page → Cart state: uses cart (evidence: `src/pages/carrito.tsx`)
- Header → Cart state: reads cart (evidence: `src/components/header.tsx`)
- Cart page → Currency formatter: formats prices (evidence: `src/pages/carrito.tsx`)
- My orders → Currency formatter: formats prices (evidence: `src/pages/misPedidos.tsx`)
- Furniture catalog → Currency formatter: formats prices (evidence: `src/pages/muebles.tsx`)
- Search results → Currency formatter: formats prices (evidence: `src/pages/buscador.tsx`)
- Furniture detail → Currency formatter: formats prices (evidence: `src/pages/muebleDetail.tsx`)
- Featured furniture → Favorite button: renders (evidence: `src/components/productoshome.tsx`)
- Furniture catalog → Favorite button: renders (evidence: `src/pages/muebles.tsx`)
- Search results → Favorite button: renders (evidence: `src/pages/buscador.tsx`)
- Furniture detail → Favorite button: renders (evidence: `src/pages/muebleDetail.tsx`)
- Favorites page → Favorite button: renders (evidence: `src/pages/favoritos.tsx`)
- Favorite button → Favorites state: toggles favorite (evidence: `src/components/FavoriteButton.tsx`)
- Favorites page → Favorites state: reads favorites (evidence: `src/pages/favoritos.tsx`)
- Featured furniture → Domain types: uses furniture types (evidence: `src/components/productoshome.tsx`)
- Cart state → Domain types: uses cart types (evidence: `src/context/carritoContext.tsx`)
- Favorites state → Domain types: uses furniture types (evidence: `src/context/favoritosContext.tsx`)
