# francalero93/perla-vintage-project architecture

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

- Interactive diagram: https://gitdiagram.com/francalero93/perla-vintage-project
- Repository: https://github.com/francalero93/perla-vintage-project

## Overview

This is a browser-based vintage clothing storefront: shoppers browse categorized products, open a product’s detail page, and can consult a size guide. The sampled code shows catalog data and rendering, price utilities, product-detail rendering, and shop category navigation. The tree also includes home and brand pages, but their behavior and page-to-script wiring were not sampled; those links are therefore omitted. The size-guide page is included as a distinct product capability, without assuming how it is implemented.

Main entry points: [`js/product-catalog.js`](https://github.com/francalero93/perla-vintage-project/blob/main/js/product-catalog.js) (Catalog rendering), [`js/product-data.js`](https://github.com/francalero93/perla-vintage-project/blob/main/js/product-data.js) (Catalog data), [`js/product.js`](https://github.com/francalero93/perla-vintage-project/blob/main/js/product.js) (Product details), [`shop.html`](https://github.com/francalero93/perla-vintage-project/blob/main/shop.html) (Shop page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront experience"]
  node_shop["Shop page<br/>[shop.html]"]
  node_category_nav["Category navigation<br/>[main.js]"]
end

subgraph group_catalog["Product catalog"]
  node_catalog_data[("Catalog data<br/>[product-data.js]")]
  node_catalog_render["Catalog rendering<br/>[product-catalog.js]"]
  node_price_utils["Price utilities<br/>[product-utils.js]"]
  node_assets["Product images"]
end

subgraph group_details["Product details"]
  node_product_page["Product page<br/>[product.html]"]
  node_product_detail["Product details<br/>[product.js]"]
end

subgraph group_content["Store content"]
  node_size_guide["Size guide<br/>[size-guide.html]"]
  node_home["Home page<br/>[perla_vintage.html]"]
  node_brand_page["Brand page<br/>[perla_vintage.html]"]
end

node_shopper(("Shopper"))

node_catalog_render -->|"reads catalog"| node_catalog_data
node_catalog_render -->|"formats prices"| node_price_utils
node_catalog_data -->|"references images"| node_assets
node_category_nav -->|"filters categories"| node_shop
node_catalog_render -->|"links products"| node_product_page
node_product_detail -->|"reads catalog"| node_catalog_data
node_product_detail -->|"formats prices"| node_price_utils
node_shopper -.->|"browses"| node_shop
node_shopper -.->|"consults sizing"| node_size_guide
node_shopper -.->|"visits"| node_home

click node_shop "https://github.com/francalero93/perla-vintage-project/blob/main/shop.html"
click node_category_nav "https://github.com/francalero93/perla-vintage-project/blob/main/js/main.js"
click node_catalog_data "https://github.com/francalero93/perla-vintage-project/blob/main/js/product-data.js"
click node_catalog_render "https://github.com/francalero93/perla-vintage-project/blob/main/js/product-catalog.js"
click node_price_utils "https://github.com/francalero93/perla-vintage-project/blob/main/js/product-utils.js"
click node_product_page "https://github.com/francalero93/perla-vintage-project/blob/main/product.html"
click node_product_detail "https://github.com/francalero93/perla-vintage-project/blob/main/js/product.js"
click node_size_guide "https://github.com/francalero93/perla-vintage-project/blob/main/size-guide.html"
click node_home "https://github.com/francalero93/perla-vintage-project/blob/main/perla_vintage.html"
click node_brand_page "https://github.com/francalero93/perla-vintage-project/blob/main/perla_vintage.html"
click node_assets "https://github.com/francalero93/perla-vintage-project/tree/main/img"

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_shop,node_category_nav toneBlue
class node_catalog_data,node_catalog_render,node_price_utils,node_assets toneAmber
class node_product_page,node_product_detail toneMint
class node_size_guide,node_home,node_brand_page toneRose
class node_shopper toneIndigo
```

## Components

### Storefront experience

- [Shop page](https://github.com/francalero93/perla-vintage-project/blob/main/shop.html): `shop.html`
- [Category navigation](https://github.com/francalero93/perla-vintage-project/blob/main/js/main.js): `js/main.js`

### Product catalog

- [Catalog data](https://github.com/francalero93/perla-vintage-project/blob/main/js/product-data.js): `js/product-data.js`
- [Catalog rendering](https://github.com/francalero93/perla-vintage-project/blob/main/js/product-catalog.js): `js/product-catalog.js`
- [Price utilities](https://github.com/francalero93/perla-vintage-project/blob/main/js/product-utils.js): `js/product-utils.js`
- [Product images](https://github.com/francalero93/perla-vintage-project/tree/main/img): `img`

### Product details

- [Product page](https://github.com/francalero93/perla-vintage-project/blob/main/product.html): `product.html`
- [Product details](https://github.com/francalero93/perla-vintage-project/blob/main/js/product.js): `js/product.js`

### Store content

- [Size guide](https://github.com/francalero93/perla-vintage-project/blob/main/size-guide.html): `size-guide.html`
- [Home page](https://github.com/francalero93/perla-vintage-project/blob/main/perla_vintage.html): `perla_vintage.html`
- [Brand page](https://github.com/francalero93/perla-vintage-project/blob/main/perla_vintage.html): `perla_vintage.html`

### Other components

- **Shopper**

## Connections

- Catalog rendering → Catalog data: reads catalog (evidence: `js/product-catalog.js`)
- Catalog rendering → Price utilities: formats prices (evidence: `js/product-catalog.js`)
- Catalog data → Product images: references images (evidence: `js/product-data.js`)
- Category navigation → Shop page: filters categories (evidence: `js/main.js`)
- Catalog rendering → Product page: links products (evidence: `js/product-catalog.js`)
- Product details → Catalog data: reads catalog (evidence: `js/product.js`)
- Product details → Price utilities: formats prices (evidence: `js/product.js`)
- Shopper → Shop page: browses
- Shopper → Size guide: consults sizing
- Shopper → Home page: visits
