# untangled-it-solutions/untangled-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/untangled-it-solutions/untangled-frontend
- Repository: https://github.com/untangled-it-solutions/untangled-frontend

## Overview

Untangled IT Solution Shop is a storefront for business IT products, refurbished devices, software and services. Customers browse or select products, manage a cart or quote list, then submit an order or quote request; quote tracking is a separate return workflow. The frontend also presents support, solutions and product-selection guidance. The README documents a Node API and JSON persistence. Edges reflect shown imports, calls and documented API routes; source for some page and server internals was not excerpted, so those details are kept at subsystem level.

Main entry points: [`src/App.tsx`](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/App.tsx) (App routing), [`src/lib/store-context.tsx`](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/store-context.tsx) (Cart and quote state), [`src/lib/api.ts`](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/api.ts) (API client), [`src/components/header.tsx`](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/components/header.tsx) (Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront experience"]
  node_app["App routing<br/>[App.tsx]"]
  node_header["Navigation<br/>[header.tsx]"]
  node_home["Home<br/>[home.tsx]"]
  node_help["Product guidance<br/>[help-me-choose.tsx]"]
  node_support["Support services<br/>[support.tsx]"]
  node_solutions["IT solutions<br/>[solutions.tsx]"]
  node_theme["Theme state<br/>[ThemeContext.tsx]"]
end

subgraph group_catalog["Catalog and selection"]
  node_catalogdata["Product catalog<br/>[store-data.ts]"]
  node_cataloglogic["Catalog definitions<br/>[catalog.ts]"]
  node_products["Products<br/>[products.tsx]"]
  node_refurbished["Refurbished devices<br/>[refurbished.tsx]"]
  node_software["Software services<br/>[software.tsx]"]
end

subgraph group_transactions["Quotes and orders"]
  node_cartstate["Cart and quote state<br/>[store-context.tsx]"]
  node_cart["Shopping cart<br/>[cart.tsx]"]
  node_quote["Quote request<br/>[quote.tsx]"]
  node_checkout["Checkout<br/>[checkout.tsx]"]
  node_tracking["Quote tracking<br/>[track-quote.tsx]"]
end

subgraph group_backend["API and persistence"]
  node_api["API client<br/>[api.ts]"]
  node_server["Node API<br/>[index.js]"]
  node_database[("JSON persistence")]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_app
node_app -->|"renders"| node_header
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_products
node_app -->|"routes to"| node_refurbished
node_app -->|"routes to"| node_software
node_app -->|"routes to"| node_support
node_app -->|"routes to"| node_solutions
node_app -->|"routes to"| node_help
node_app -->|"routes to"| node_cart
node_app -->|"routes to"| node_checkout
node_app -->|"opens"| node_quote
node_app -->|"routes to"| node_tracking
node_header -->|"reads counts"| node_cartstate
node_header -->|"reads theme"| node_theme
node_app -->|"provides state"| node_cartstate
node_products -->|"uses"| node_cartstate
node_products -->|"reads products"| node_catalogdata
node_refurbished -->|"uses"| node_cartstate
node_refurbished -->|"reads products"| node_catalogdata
node_software -->|"reads catalog"| node_cataloglogic
node_support -->|"reads catalog"| node_cataloglogic
node_solutions -->|"reads catalog"| node_cataloglogic
node_help -->|"uses"| node_cartstate
node_cartstate -->|"loads products"| node_catalogdata
node_cart -->|"uses"| node_cartstate
node_checkout -->|"uses"| node_cartstate
node_quote -->|"uses"| node_cartstate
node_quote -->|"submits quote"| node_api
node_checkout -->|"submits order"| node_api
node_tracking -->|"tracks quote"| node_api
node_api -->|"calls HTTP routes"| node_server
node_server -->|"persists records"| node_database

click node_app "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/App.tsx"
click node_header "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/components/header.tsx"
click node_home "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/home.tsx"
click node_help "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/help-me-choose.tsx"
click node_support "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/support.tsx"
click node_solutions "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/solutions.tsx"
click node_theme "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/context/ThemeContext.tsx"
click node_catalogdata "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/store-data.ts"
click node_cataloglogic "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/catalog.ts"
click node_products "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/products.tsx"
click node_refurbished "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/refurbished.tsx"
click node_software "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/software.tsx"
click node_cartstate "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/store-context.tsx"
click node_cart "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/cart.tsx"
click node_quote "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/quote.tsx"
click node_checkout "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/checkout.tsx"
click node_tracking "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/track-quote.tsx"
click node_api "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/api.ts"
click node_server "https://github.com/untangled-it-solutions/untangled-frontend/blob/main/server/index.js"
click node_database "https://github.com/untangled-it-solutions/untangled-frontend/tree/main/server/data"

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_header,node_home,node_help,node_support,node_solutions,node_theme toneBlue
class node_catalogdata,node_cataloglogic,node_products,node_refurbished,node_software toneAmber
class node_cartstate,node_cart,node_quote,node_checkout,node_tracking toneMint
class node_api,node_server,node_database toneRose
class node_customer toneIndigo
```

## Components

### Storefront experience

- [App routing](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/components/header.tsx): `src/components/header.tsx`
- [Home](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/home.tsx): `src/pages/home.tsx`
- [Product guidance](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/help-me-choose.tsx): `src/pages/help-me-choose.tsx`
- [Support services](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/support.tsx): `src/pages/support.tsx`
- [IT solutions](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/solutions.tsx): `src/pages/solutions.tsx`
- [Theme state](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/context/ThemeContext.tsx): `src/context/ThemeContext.tsx`

### Catalog and selection

- [Product catalog](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/store-data.ts): `src/lib/store-data.ts`
- [Catalog definitions](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/catalog.ts): `src/lib/catalog.ts`
- [Products](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/products.tsx): `src/pages/products.tsx`
- [Refurbished devices](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/refurbished.tsx): `src/pages/refurbished.tsx`
- [Software services](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/software.tsx): `src/pages/software.tsx`

### Quotes and orders

- [Cart and quote state](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/store-context.tsx): `src/lib/store-context.tsx`
- [Shopping cart](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/cart.tsx): `src/pages/cart.tsx`
- [Quote request](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/quote.tsx): `src/pages/quote.tsx`
- [Checkout](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/checkout.tsx): `src/pages/checkout.tsx`
- [Quote tracking](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/pages/track-quote.tsx): `src/pages/track-quote.tsx`

### API and persistence

- [API client](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [Node API](https://github.com/untangled-it-solutions/untangled-frontend/blob/main/server/index.js): `server/index.js`
- [JSON persistence](https://github.com/untangled-it-solutions/untangled-frontend/tree/main/server/data): `server/data`

### Other components

- **Customer**

## Connections

- Customer → App routing: uses (evidence: `README.md`)
- App routing → Navigation: renders (evidence: `src/App.tsx`)
- App routing → Home: routes to (evidence: `src/App.tsx`)
- App routing → Products: routes to (evidence: `src/App.tsx`)
- App routing → Refurbished devices: routes to (evidence: `src/App.tsx`)
- App routing → Software services: routes to (evidence: `src/App.tsx`)
- App routing → Support services: routes to (evidence: `src/App.tsx`)
- App routing → IT solutions: routes to (evidence: `src/App.tsx`)
- App routing → Product guidance: routes to (evidence: `src/App.tsx`)
- App routing → Shopping cart: routes to (evidence: `src/App.tsx`)
- App routing → Checkout: routes to (evidence: `src/App.tsx`)
- App routing → Quote request: opens (evidence: `src/App.tsx`)
- App routing → Quote tracking: routes to (evidence: `src/App.tsx`)
- Navigation → Cart and quote state: reads counts (evidence: `src/components/header.tsx`)
- Navigation → Theme state: reads theme (evidence: `src/components/header.tsx`)
- App routing → Cart and quote state: provides state (evidence: `src/App.tsx`)
- Products → Cart and quote state: uses (evidence: `src/pages/products.tsx`)
- Products → Product catalog: reads products (evidence: `src/pages/products.tsx`)
- Refurbished devices → Cart and quote state: uses (evidence: `src/pages/refurbished.tsx`)
- Refurbished devices → Product catalog: reads products (evidence: `src/pages/refurbished.tsx`)
- Software services → Catalog definitions: reads catalog (evidence: `src/pages/software.tsx`)
- Support services → Catalog definitions: reads catalog (evidence: `src/pages/support.tsx`)
- IT solutions → Catalog definitions: reads catalog (evidence: `src/pages/solutions.tsx`)
- Product guidance → Cart and quote state: uses (evidence: `src/App.tsx`)
- Cart and quote state → Product catalog: loads products (evidence: `src/lib/store-context.tsx`)
- Shopping cart → Cart and quote state: uses (evidence: `src/pages/cart.tsx`)
- Checkout → Cart and quote state: uses (evidence: `src/pages/checkout.tsx`)
- Quote request → Cart and quote state: uses (evidence: `src/pages/quote.tsx`)
- Quote request → API client: submits quote (evidence: `src/pages/quote.tsx`)
- Checkout → API client: submits order (evidence: `src/pages/checkout.tsx`)
- Quote tracking → API client: tracks quote (evidence: `src/pages/track-quote.tsx`)
- API client → Node API: calls HTTP routes (evidence: `README.md`)
- Node API → JSON persistence: persists records (evidence: `README.md`)
