# dutta-aman/nutribasket-tweaks architecture

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

- Interactive diagram: https://gitdiagram.com/dutta-aman/nutribasket-tweaks
- Repository: https://github.com/dutta-aman/nutribasket-tweaks

## Overview

NutriBasket is a nutrition-aware shopping web app. A shopper scans a barcode or enters a GTIN; the app validates and resolves it through the API, displays nutrition and optional personalized guidance, and can add it to a basket before a simulated checkout and receipt. The app also supports QR deep links, scan history, and optional Google-linked profiles. The graph reflects documented flows and references in the supplied excerpts and README; unsampled implementation details are not inferred.

Main entry points: [`src/App.jsx`](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/App.jsx) (App routing), [`src/screens/ProductInfo.jsx`](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/ProductInfo.jsx) (Product details), [`src/lib/storage.js`](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/storage.js) (Local profile and history), [`src/screens/Home.jsx`](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Home.jsx) (Home dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Shopping app"]
  node_app["App routing<br/>[App.jsx]"]
  node_scan["Scan screen<br/>[ScanProduct.jsx]"]
  node_scanner["Camera scanner<br/>[BarcodeScanner.jsx]"]
  node_barcode["GTIN and QR parsing<br/>[barcode.js]"]
  node_product["Product details<br/>[ProductInfo.jsx]"]
  node_home["Home dashboard<br/>[Home.jsx]"]
end

subgraph group_nutrition["Nutrition guidance"]
  node_fit["Personal fit and risks"]
  node_bmi["BMI and targets<br/>[bmi.js]"]
  node_explain["Nutrition explanations<br/>[explainer.js]"]
  node_recommend["Food recommendations<br/>[recommendations.js]"]
end

subgraph group_identity["Profile and history"]
  node_profile["Profile setup<br/>[Profile.jsx]"]
  node_auth["Google account panel<br/>[AuthPanel.jsx]"]
  node_account["Account state<br/>[account.js]"]
  node_storage["Local profile and history<br/>[storage.js]"]
end

subgraph group_catalog["Product lookup"]
  node_api["Product API client<br/>[api.js]"]
  node_server["Express API<br/>[index.js]"]
  node_seed[("SQLite product seed<br/>[seed.js]")]
  node_off["Open Food Facts lookup<br/>[off.js]"]
  node_cache[("Lookup cache<br/>[cache.js]")]
end

subgraph group_purchase["Basket and checkout"]
  node_basket["Basket totals<br/>[Basket.jsx]"]
  node_checkout["Demo checkout<br/>[Checkout.jsx]"]
  node_receipt["Payment receipt<br/>[PaymentSuccess.jsx]"]
end

node_shopper(("Shopper"))
node_browserstore[("Browser local storage")]
node_openfood["Open Food Facts"]
node_google["Google Identity"]

node_shopper -->|"uses"| node_app
node_app -->|"routes to"| node_scan
node_app -->|"routes to"| node_product
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_basket
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_receipt
node_scan -->|"renders"| node_scanner
node_scanner -->|"parses codes"| node_barcode
node_app -->|"parses deep links"| node_barcode
node_app -->|"requests product"| node_api
node_api -->|"calls API"| node_server
node_server -->|"checks first"| node_seed
node_server -->|"falls back"| node_off
node_off -->|"reads and writes"| node_cache
node_off -->|"fetches product"| node_openfood
node_product -->|"computes guidance"| node_recommend
node_product -->|"renders"| node_fit
node_fit -->|"uses targets"| node_bmi
node_fit -->|"uses explanations"| node_explain
node_explain -->|"computes targets"| node_bmi
node_app -->|"loads and saves"| node_storage
node_home -->|"loads scan history"| node_storage
node_profile -->|"renders account panel"| node_auth
node_home -->|"renders account panel"| node_auth
node_auth -.->|"verifies token"| node_google
node_app -->|"reads account state"| node_account
node_account -->|"uses profile storage"| node_storage
node_storage -->|"reads and writes"| node_browserstore
node_basket -.->|"uses product details"| node_product
node_checkout -.->|"continues to receipt"| node_receipt

click node_app "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/App.jsx"
click node_scan "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/ScanProduct.jsx"
click node_scanner "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/components/scanner/BarcodeScanner.jsx"
click node_barcode "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/barcode.js"
click node_product "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/ProductInfo.jsx"
click node_home "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Home.jsx"
click node_profile "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Profile.jsx"
click node_auth "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/components/AuthPanel.jsx"
click node_account "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/account.js"
click node_storage "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/storage.js"
click node_fit "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/components/PersonalFitCard.jsx"
click node_bmi "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/bmi.js"
click node_explain "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/explainer.js"
click node_recommend "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/recommendations.js"
click node_basket "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Basket.jsx"
click node_checkout "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Checkout.jsx"
click node_receipt "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/PaymentSuccess.jsx"
click node_api "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/api.js"
click node_server "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/server/index.js"
click node_seed "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/server/lib/seed.js"
click node_off "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/server/lib/off.js"
click node_cache "https://github.com/dutta-aman/nutribasket-tweaks/blob/main/server/lib/cache.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,node_scan,node_scanner,node_barcode,node_product,node_home toneBlue
class node_fit,node_bmi,node_explain,node_recommend,node_browserstore toneAmber
class node_profile,node_auth,node_account,node_storage toneMint
class node_api,node_server,node_seed,node_off,node_cache toneRose
class node_basket,node_checkout,node_receipt,node_shopper,node_openfood,node_google toneIndigo
```

## Components

### Shopping app

- [App routing](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/App.jsx): `src/App.jsx`
- [Scan screen](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/ScanProduct.jsx): `src/screens/ScanProduct.jsx`
- [Camera scanner](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/components/scanner/BarcodeScanner.jsx): `src/components/scanner/BarcodeScanner.jsx`
- [GTIN and QR parsing](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/barcode.js): `src/lib/barcode.js`
- [Product details](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/ProductInfo.jsx): `src/screens/ProductInfo.jsx`
- [Home dashboard](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Home.jsx): `src/screens/Home.jsx`

### Nutrition guidance

- [Personal fit and risks](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/components/PersonalFitCard.jsx): `src/components/PersonalFitCard.jsx`
- [BMI and targets](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/bmi.js): `src/lib/bmi.js`
- [Nutrition explanations](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/explainer.js): `src/lib/explainer.js`
- [Food recommendations](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/recommendations.js): `src/lib/recommendations.js`

### Profile and history

- [Profile setup](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Profile.jsx): `src/screens/Profile.jsx`
- [Google account panel](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/components/AuthPanel.jsx): `src/components/AuthPanel.jsx`
- [Account state](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/account.js): `src/lib/account.js`
- [Local profile and history](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/storage.js): `src/lib/storage.js`

### Product lookup

- [Product API client](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/lib/api.js): `src/lib/api.js`
- [Express API](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/server/index.js): `server/index.js`
- [SQLite product seed](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/server/lib/seed.js): `server/lib/seed.js`
- [Open Food Facts lookup](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/server/lib/off.js): `server/lib/off.js`
- [Lookup cache](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/server/lib/cache.js): `server/lib/cache.js`

### Basket and checkout

- [Basket totals](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Basket.jsx): `src/screens/Basket.jsx`
- [Demo checkout](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/Checkout.jsx): `src/screens/Checkout.jsx`
- [Payment receipt](https://github.com/dutta-aman/nutribasket-tweaks/blob/main/src/screens/PaymentSuccess.jsx): `src/screens/PaymentSuccess.jsx`

### Other components

- **Shopper**
- **Browser local storage**
- **Open Food Facts**
- **Google Identity**

## Connections

- Shopper → App routing: uses (evidence: `README.md`)
- App routing → Scan screen: routes to (evidence: `src/App.jsx`)
- App routing → Product details: routes to (evidence: `src/App.jsx`)
- App routing → Home dashboard: routes to (evidence: `src/App.jsx`)
- App routing → Profile setup: routes to (evidence: `src/App.jsx`)
- App routing → Basket totals: routes to (evidence: `src/App.jsx`)
- App routing → Demo checkout: routes to (evidence: `src/App.jsx`)
- App routing → Payment receipt: routes to (evidence: `src/App.jsx`)
- Scan screen → Camera scanner: renders (evidence: `src/screens/ScanProduct.jsx`)
- Camera scanner → GTIN and QR parsing: parses codes (evidence: `src/components/scanner/BarcodeScanner.jsx`)
- App routing → GTIN and QR parsing: parses deep links (evidence: `src/App.jsx`)
- App routing → Product API client: requests product (evidence: `src/App.jsx`)
- Product API client → Express API: calls API (evidence: `README.md`)
- Express API → SQLite product seed: checks first (evidence: `server/index.js`)
- Express API → Open Food Facts lookup: falls back (evidence: `server/index.js`)
- Open Food Facts lookup → Lookup cache: reads and writes (evidence: `server/lib/off.js`)
- Open Food Facts lookup → Open Food Facts: fetches product (evidence: `README.md`)
- Product details → Food recommendations: computes guidance (evidence: `src/screens/ProductInfo.jsx`)
- Product details → Personal fit and risks: renders (evidence: `src/screens/ProductInfo.jsx`)
- Personal fit and risks → BMI and targets: uses targets (evidence: `src/components/PersonalFitCard.jsx`)
- Personal fit and risks → Nutrition explanations: uses explanations (evidence: `src/components/PersonalFitCard.jsx`)
- Nutrition explanations → BMI and targets: computes targets (evidence: `src/lib/explainer.js`)
- App routing → Local profile and history: loads and saves (evidence: `src/App.jsx`)
- Home dashboard → Local profile and history: loads scan history (evidence: `src/screens/Home.jsx`)
- Profile setup → Google account panel: renders account panel (evidence: `src/screens/Profile.jsx`)
- Home dashboard → Google account panel: renders account panel (evidence: `src/screens/Home.jsx`)
- Google account panel → Google Identity: verifies token (evidence: `README.md`)
- App routing → Account state: reads account state (evidence: `src/App.jsx`)
- Account state → Local profile and history: uses profile storage (evidence: `src/lib/account.js`)
- Local profile and history → Browser local storage: reads and writes (evidence: `src/lib/storage.js`)
- Basket totals → Product details: uses product details (evidence: `README.md`)
- Demo checkout → Payment receipt: continues to receipt (evidence: `README.md`)
