# paqueraud/glucia architecture

> Architecture diagram of the GitHub repository paqueraud/glucia, 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/paqueraud/glucia
- Repository: https://github.com/paqueraud/glucia

## Overview

This appears to be a browser-based meal and carbohydrate tracking app: users manage profiles, capture or upload meal photos, review food and carbohydrate estimates, and track meal sessions. The source excerpts show the app shell, photo capture, food lookup, LLM analysis, and local persistence; the README is still the generic Vite template and documents no product workflow. Some page and service relationships are supported only by the SOURCE INDEX, so unsampled behavior is not expanded beyond those references.

Main entry points: [`src/App.tsx`](https://github.com/paqueraud/glucia/blob/main/src/App.tsx) (App shell), [`src/pages/SessionPage.tsx`](https://github.com/paqueraud/glucia/blob/main/src/pages/SessionPage.tsx) (Meal session), [`src/services/food/index.ts`](https://github.com/paqueraud/glucia/blob/main/src/services/food/index.ts) (Food lookup), [`src/services/llm/index.ts`](https://github.com/paqueraud/glucia/blob/main/src/services/llm/index.ts) (Meal analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_app["App shell<br/>[App.tsx]"]
  node_home["Home<br/>[HomePage.tsx]"]
  node_user_select["User selector<br/>[UserSelector.tsx]"]
  node_user_form["Profile editor<br/>[UserForm.tsx]"]
  node_about["About page<br/>[AboutPage.tsx]"]
  node_help["Help page<br/>[HelpPage.tsx]"]
end

subgraph group_meal["Meal workflow"]
  node_session["Meal session<br/>[SessionPage.tsx]"]
  node_camera_ui["Photo capture<br/>[CameraCapture.tsx]"]
  node_camera_service["Camera utilities<br/>[index.ts]"]
  node_photo_view["Photo viewer<br/>[PhotoViewer.tsx]"]
  node_food_card["Food item review<br/>[FoodItemCard.tsx]"]
  node_header["Session header<br/>[Header.tsx]"]
end

subgraph group_food["Food and analysis"]
  node_food_page["Food database page"]
  node_food_picker["Food picker"]
  node_food_service["Food lookup<br/>[index.ts]"]
  node_llm_service["Meal analysis<br/>[index.ts]"]
  node_mediapipe["MediaPipe service<br/>[index.ts]"]
end

subgraph group_data["Local data and settings"]
  node_store["App state<br/>[appStore.ts]"]
  node_db[("IndexedDB<br/>[index.ts]")]
  node_llm_settings["AI settings<br/>[LLMSettings.tsx]"]
  node_import_export["Import and export<br/>[ImportExport.tsx]"]
  node_export_service["Export service<br/>[index.ts]"]
end

node_user(("User"))
node_openfoodfacts{{"Open Food Facts"}}

node_user -.->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_session
node_app -->|"opens"| node_user_form
node_app -->|"routes to"| node_about
node_app -->|"routes to"| node_help
node_app -->|"routes to"| node_food_page
node_app -->|"reads state"| node_store
node_app -->|"loads users"| node_db
node_home -->|"renders"| node_camera_ui
node_home -->|"renders"| node_user_select
node_home -->|"calls"| node_llm_service
node_home -->|"calls"| node_food_service
node_home -->|"reads"| node_db
node_camera_ui -->|"uses"| node_camera_service
node_session -->|"renders"| node_header
node_session -->|"renders"| node_photo_view
node_session -->|"renders"| node_food_card
node_session -->|"renders"| node_camera_ui
node_session -->|"uses state"| node_store
node_session -->|"checks cache"| node_llm_service
node_session -->|"looks up food"| node_food_service
node_food_card -->|"updates items"| node_store
node_food_card -->|"requests analysis"| node_llm_service
node_food_card -->|"looks up food"| node_food_service
node_food_card -->|"renders"| node_food_picker
node_food_page -->|"manages entries"| node_food_service
node_food_picker -->|"searches"| node_food_service
node_food_service -->|"reads and writes"| node_db
node_food_service -->|"queries"| node_openfoodfacts
node_llm_service -->|"looks up nutrients"| node_food_service
node_llm_service -->|"uses image tools"| node_camera_service
node_llm_service -->|"reads and writes cache"| node_db
node_user_form -->|"saves profiles"| node_db
node_user_form -->|"uses photo tools"| node_camera_service
node_llm_settings -->|"configures and tests"| node_llm_service
node_llm_settings -->|"refreshes state"| node_store
node_import_export -->|"uses"| node_export_service
node_import_export -->|"uses"| node_food_service
node_export_service -->|"reads data"| node_db
node_store -->|"persists sessions"| node_db
node_store -->|"saves cache"| node_llm_service

click node_app "https://github.com/paqueraud/glucia/blob/main/src/App.tsx"
click node_home "https://github.com/paqueraud/glucia/blob/main/src/pages/HomePage.tsx"
click node_session "https://github.com/paqueraud/glucia/blob/main/src/pages/SessionPage.tsx"
click node_camera_ui "https://github.com/paqueraud/glucia/blob/main/src/components/camera/CameraCapture.tsx"
click node_camera_service "https://github.com/paqueraud/glucia/blob/main/src/services/camera/index.ts"
click node_photo_view "https://github.com/paqueraud/glucia/blob/main/src/components/session/PhotoViewer.tsx"
click node_food_card "https://github.com/paqueraud/glucia/blob/main/src/components/session/FoodItemCard.tsx"
click node_header "https://github.com/paqueraud/glucia/blob/main/src/components/layout/Header.tsx"
click node_user_select "https://github.com/paqueraud/glucia/blob/main/src/components/user/UserSelector.tsx"
click node_user_form "https://github.com/paqueraud/glucia/blob/main/src/components/user/UserForm.tsx"
click node_food_page "https://github.com/paqueraud/glucia/blob/main/src/pages/FoodDatabasePage.tsx"
click node_food_picker "https://github.com/paqueraud/glucia/blob/main/src/components/session/FoodDatabasePicker.tsx"
click node_food_service "https://github.com/paqueraud/glucia/blob/main/src/services/food/index.ts"
click node_llm_service "https://github.com/paqueraud/glucia/blob/main/src/services/llm/index.ts"
click node_mediapipe "https://github.com/paqueraud/glucia/blob/main/src/services/mediapipe/index.ts"
click node_store "https://github.com/paqueraud/glucia/blob/main/src/stores/appStore.ts"
click node_db "https://github.com/paqueraud/glucia/blob/main/src/db/index.ts"
click node_llm_settings "https://github.com/paqueraud/glucia/blob/main/src/components/settings/LLMSettings.tsx"
click node_import_export "https://github.com/paqueraud/glucia/blob/main/src/components/settings/ImportExport.tsx"
click node_export_service "https://github.com/paqueraud/glucia/blob/main/src/services/export/index.ts"
click node_about "https://github.com/paqueraud/glucia/blob/main/src/pages/AboutPage.tsx"
click node_help "https://github.com/paqueraud/glucia/blob/main/src/pages/HelpPage.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,node_home,node_user_select,node_user_form,node_about,node_help,node_user toneBlue
class node_session,node_camera_ui,node_camera_service,node_photo_view,node_food_card,node_header toneAmber
class node_food_page,node_food_picker,node_food_service,node_llm_service,node_mediapipe toneMint
class node_store,node_db,node_llm_settings,node_import_export,node_export_service toneRose
class node_openfoodfacts toneIndigo
```

## Components

### App navigation

- [App shell](https://github.com/paqueraud/glucia/blob/main/src/App.tsx): `src/App.tsx`
- [Home](https://github.com/paqueraud/glucia/blob/main/src/pages/HomePage.tsx): `src/pages/HomePage.tsx`
- [User selector](https://github.com/paqueraud/glucia/blob/main/src/components/user/UserSelector.tsx): `src/components/user/UserSelector.tsx`
- [Profile editor](https://github.com/paqueraud/glucia/blob/main/src/components/user/UserForm.tsx): `src/components/user/UserForm.tsx`
- [About page](https://github.com/paqueraud/glucia/blob/main/src/pages/AboutPage.tsx): `src/pages/AboutPage.tsx`
- [Help page](https://github.com/paqueraud/glucia/blob/main/src/pages/HelpPage.tsx): `src/pages/HelpPage.tsx`

### Meal workflow

- [Meal session](https://github.com/paqueraud/glucia/blob/main/src/pages/SessionPage.tsx): `src/pages/SessionPage.tsx`
- [Photo capture](https://github.com/paqueraud/glucia/blob/main/src/components/camera/CameraCapture.tsx): `src/components/camera/CameraCapture.tsx`
- [Camera utilities](https://github.com/paqueraud/glucia/blob/main/src/services/camera/index.ts): `src/services/camera/index.ts`
- [Photo viewer](https://github.com/paqueraud/glucia/blob/main/src/components/session/PhotoViewer.tsx): `src/components/session/PhotoViewer.tsx`
- [Food item review](https://github.com/paqueraud/glucia/blob/main/src/components/session/FoodItemCard.tsx): `src/components/session/FoodItemCard.tsx`
- [Session header](https://github.com/paqueraud/glucia/blob/main/src/components/layout/Header.tsx): `src/components/layout/Header.tsx`

### Food and analysis

- [Food database page](https://github.com/paqueraud/glucia/blob/main/src/pages/FoodDatabasePage.tsx): `src/pages/FoodDatabasePage.tsx`
- [Food picker](https://github.com/paqueraud/glucia/blob/main/src/components/session/FoodDatabasePicker.tsx): `src/components/session/FoodDatabasePicker.tsx`
- [Food lookup](https://github.com/paqueraud/glucia/blob/main/src/services/food/index.ts): `src/services/food/index.ts`
- [Meal analysis](https://github.com/paqueraud/glucia/blob/main/src/services/llm/index.ts): `src/services/llm/index.ts`
- [MediaPipe service](https://github.com/paqueraud/glucia/blob/main/src/services/mediapipe/index.ts): `src/services/mediapipe/index.ts`

### Local data and settings

- [App state](https://github.com/paqueraud/glucia/blob/main/src/stores/appStore.ts): `src/stores/appStore.ts`
- [IndexedDB](https://github.com/paqueraud/glucia/blob/main/src/db/index.ts): `src/db/index.ts`
- [AI settings](https://github.com/paqueraud/glucia/blob/main/src/components/settings/LLMSettings.tsx): `src/components/settings/LLMSettings.tsx`
- [Import and export](https://github.com/paqueraud/glucia/blob/main/src/components/settings/ImportExport.tsx): `src/components/settings/ImportExport.tsx`
- [Export service](https://github.com/paqueraud/glucia/blob/main/src/services/export/index.ts): `src/services/export/index.ts`

### Other components

- **User**
- **Open Food Facts**

## Connections

- User → App shell: uses
- App shell → Home: routes to (evidence: `src/App.tsx`)
- App shell → Meal session: routes to (evidence: `src/App.tsx`)
- App shell → Profile editor: opens (evidence: `src/App.tsx`)
- App shell → About page: routes to (evidence: `src/App.tsx`)
- App shell → Help page: routes to (evidence: `src/App.tsx`)
- App shell → Food database page: routes to (evidence: `src/App.tsx`)
- App shell → App state: reads state (evidence: `src/App.tsx`)
- App shell → IndexedDB: loads users (evidence: `src/App.tsx`)
- Home → Photo capture: renders (evidence: `src/pages/HomePage.tsx`)
- Home → User selector: renders (evidence: `src/pages/HomePage.tsx`)
- Home → Meal analysis: calls (evidence: `src/pages/HomePage.tsx`)
- Home → Food lookup: calls (evidence: `src/pages/HomePage.tsx`)
- Home → IndexedDB: reads (evidence: `src/pages/HomePage.tsx`)
- Photo capture → Camera utilities: uses (evidence: `src/components/camera/CameraCapture.tsx`)
- Meal session → Session header: renders (evidence: `src/pages/SessionPage.tsx`)
- Meal session → Photo viewer: renders (evidence: `src/pages/SessionPage.tsx`)
- Meal session → Food item review: renders (evidence: `src/pages/SessionPage.tsx`)
- Meal session → Photo capture: renders (evidence: `src/pages/SessionPage.tsx`)
- Meal session → App state: uses state (evidence: `src/pages/SessionPage.tsx`)
- Meal session → Meal analysis: checks cache (evidence: `src/pages/SessionPage.tsx`)
- Meal session → Food lookup: looks up food (evidence: `src/pages/SessionPage.tsx`)
- Food item review → App state: updates items (evidence: `src/components/session/FoodItemCard.tsx`)
- Food item review → Meal analysis: requests analysis (evidence: `src/components/session/FoodItemCard.tsx`)
- Food item review → Food lookup: looks up food (evidence: `src/components/session/FoodItemCard.tsx`)
- Food item review → Food picker: renders (evidence: `src/components/session/FoodItemCard.tsx`)
- Food database page → Food lookup: manages entries (evidence: `src/pages/FoodDatabasePage.tsx`)
- Food picker → Food lookup: searches (evidence: `src/components/session/FoodDatabasePicker.tsx`)
- Food lookup → IndexedDB: reads and writes (evidence: `src/services/food/index.ts`)
- Food lookup → Open Food Facts: queries (evidence: `src/services/food/index.ts`)
- Meal analysis → Food lookup: looks up nutrients (evidence: `src/services/llm/index.ts`)
- Meal analysis → Camera utilities: uses image tools (evidence: `src/services/llm/index.ts`)
- Meal analysis → IndexedDB: reads and writes cache (evidence: `src/services/llm/index.ts`)
- Profile editor → IndexedDB: saves profiles (evidence: `src/components/user/UserForm.tsx`)
- Profile editor → Camera utilities: uses photo tools (evidence: `src/components/user/UserForm.tsx`)
- AI settings → Meal analysis: configures and tests (evidence: `src/components/settings/LLMSettings.tsx`)
- AI settings → App state: refreshes state (evidence: `src/components/settings/LLMSettings.tsx`)
- Import and export → Export service: uses (evidence: `src/components/settings/ImportExport.tsx`)
- Import and export → Food lookup: uses (evidence: `src/components/settings/ImportExport.tsx`)
- Export service → IndexedDB: reads data (evidence: `src/services/export/index.ts`)
- App state → IndexedDB: persists sessions (evidence: `src/stores/appStore.ts`)
- App state → Meal analysis: saves cache (evidence: `src/stores/appStore.ts`)
