# tranbaodev/nutrition-tracker-recognition-app architecture

> Architecture diagram of the GitHub repository tranbaodev/nutrition-tracker-recognition-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tranbaodev/nutrition-tracker-recognition-app
- Repository: https://github.com/tranbaodev/nutrition-tracker-recognition-app

## Overview

OpenNutriTracker is a Flutter mobile nutrition tracker. Its documented user workflow is to find food (including barcode lookup), log meals, and review consumption and progress in a diary. The tree shows feature areas for meals, scanning, diary, activity, onboarding, profile, and settings, but no Dart implementation excerpts were supplied; links between these stages and their data sources therefore remain unverified. The README names Open Food Facts and FoodData Central as food-data providers.

Main entry points: [`lib/core/data/repository`](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/data/repository) (Data Repositories), [`lib/features/add_meal/data`](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_meal/data) (Food Catalogues), [`lib/features/add_meal`](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_meal) (Find Food), [`lib/features/scanner`](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/scanner) (Barcode Scanner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_food["Food Logging"]
  node_meal_search["Find Food"]
  node_meal_entry["Add Meal"]
  node_meal_edit["Edit Meal"]
  node_meal_detail["Meal Detail"]
  node_food_sources["Food Catalogues"]
  node_scanner["Barcode Scanner"]
end

subgraph group_tracking["Daily Tracking"]
  node_diary["Food Diary"]
  node_home["Nutrition Overview"]
  node_activity_add["Log Activity"]
  node_activity_detail["Activity Detail"]
end

subgraph group_account["User Setup"]
  node_onboarding["Onboarding"]
  node_profile["Profile"]
  node_settings["Settings"]
end

subgraph group_shared["Shared App"]
  node_domain["Domain Logic"]
  node_repositories["Data Repositories"]
  node_local_data[("Local Data")]
  node_app_ui["Shared UI"]
end

node_user(("User"))
node_food_api{{"Food Data Services"}}

node_user -.->|"searches foods"| node_meal_search
node_user -.->|"scans barcode"| node_scanner
node_user -.->|"logs meals"| node_meal_entry
node_user -.->|"reviews diary"| node_diary
node_user -.->|"reviews progress"| node_home
node_user -.->|"logs activity"| node_activity_add
node_user -.->|"sets up profile"| node_onboarding
node_user -.->|"changes settings"| node_settings
node_meal_search -.->|"queries"| node_food_sources
node_food_sources -.->|"requests food data"| node_food_api
node_scanner -.->|"looks up barcode"| node_food_sources
node_meal_entry -.->|"persists meal"| node_repositories
node_diary -.->|"loads entries"| node_repositories
node_home -.->|"computes overview"| node_domain
node_repositories -.->|"reads and writes"| node_local_data
node_onboarding -.->|"stores profile"| node_repositories

click node_meal_search "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_meal"
click node_meal_entry "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_meal"
click node_meal_edit "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/edit_meal"
click node_meal_detail "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/meal_detail"
click node_food_sources "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_meal/data"
click node_scanner "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/scanner"
click node_diary "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/diary"
click node_home "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/home"
click node_activity_add "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_activity"
click node_activity_detail "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/activity_detail"
click node_onboarding "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/onboarding"
click node_profile "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/profile"
click node_settings "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/settings"
click node_domain "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/domain"
click node_repositories "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/data/repository"
click node_local_data "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/data/data_source"
click node_app_ui "https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/presentation"

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_meal_search,node_meal_entry,node_meal_edit,node_meal_detail,node_food_sources,node_scanner,node_user toneBlue
class node_diary,node_home,node_activity_add,node_activity_detail toneAmber
class node_onboarding,node_profile,node_settings toneMint
class node_domain,node_repositories,node_local_data,node_app_ui toneRose
class node_food_api toneIndigo
```

## Components

### Food Logging

- [Find Food](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_meal): `lib/features/add_meal`
- [Add Meal](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_meal): `lib/features/add_meal`
- [Edit Meal](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/edit_meal): `lib/features/edit_meal`
- [Meal Detail](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/meal_detail): `lib/features/meal_detail`
- [Food Catalogues](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_meal/data): `lib/features/add_meal/data`
- [Barcode Scanner](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/scanner): `lib/features/scanner`

### Daily Tracking

- [Food Diary](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/diary): `lib/features/diary`
- [Nutrition Overview](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/home): `lib/features/home`
- [Log Activity](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/add_activity): `lib/features/add_activity`
- [Activity Detail](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/activity_detail): `lib/features/activity_detail`

### User Setup

- [Onboarding](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/onboarding): `lib/features/onboarding`
- [Profile](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/profile): `lib/features/profile`
- [Settings](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/features/settings): `lib/features/settings`

### Shared App

- [Domain Logic](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/domain): `lib/core/domain`
- [Data Repositories](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/data/repository): `lib/core/data/repository`
- [Local Data](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/data/data_source): `lib/core/data/data_source`
- [Shared UI](https://github.com/tranbaodev/nutrition-tracker-recognition-app/tree/main/lib/core/presentation): `lib/core/presentation`

### Other components

- **User**
- **Food Data Services**

## Connections

- User → Find Food: searches foods
- User → Barcode Scanner: scans barcode
- User → Add Meal: logs meals
- User → Food Diary: reviews diary
- User → Nutrition Overview: reviews progress
- User → Log Activity: logs activity
- User → Onboarding: sets up profile
- User → Settings: changes settings
- Find Food → Food Catalogues: queries
- Food Catalogues → Food Data Services: requests food data
- Barcode Scanner → Food Catalogues: looks up barcode
- Add Meal → Data Repositories: persists meal
- Food Diary → Data Repositories: loads entries
- Nutrition Overview → Domain Logic: computes overview
- Data Repositories → Local Data: reads and writes
- Onboarding → Data Repositories: stores profile
