# sifal2001/fait-maison architecture

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

- Interactive diagram: https://gitdiagram.com/sifal2001/fait-maison
- Repository: https://github.com/sifal2001/fait-maison

## Overview

The repository is a Flutter application whose README still describes a starter project. Its file tree suggests recipe discovery, fridge-based recommendations, scanning, nutrition, preferences, and account features, but no application source was excerpted, so runtime call relationships cannot be verified. The graph maps these apparent subsystems and marks inferred connections as unverified; it does not include platform build or test machinery.

Main entry points: [`lib/screens/home.dart`](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/home.dart) (Home), [`lib/main.dart`](https://github.com/sifal2001/fait-maison/blob/main/lib/main.dart) (App entry), [`lib/screens/meal_card.dart`](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/meal_card.dart) (Meal cards), [`lib/screens/show_recipe.dart`](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/show_recipe.dart) (Recipe view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and screens"]
  node_entry["App entry<br/>[main.dart]"]
  node_home["Home<br/>[home.dart]"]
  node_mealcard["Meal cards<br/>[meal_card.dart]"]
end

subgraph group_recipes["Recipe workflows"]
  node_recipeview["Recipe view<br/>[show_recipe.dart]"]
  node_fridgepick["Fridge item picker"]
  node_fridgerecipes["Fridge recipes"]
  node_scan["Scan and learn"]
  node_nutrition["Nutrition"]
  node_recipe["Recipe data<br/>[recipe.dart]"]
end

subgraph group_user["User features"]
  node_auth["Authentication<br/>[login.dart]"]
  node_register["Registration<br/>[register.dart]"]
  node_preferences["Preferences<br/>[preferences.dart]"]
  node_blacklist["Recipe blacklist<br/>[black_list.dart]"]
end

subgraph group_data["Services and state"]
  node_authstate["Auth state<br/>[auth_provider.dart]"]
  node_recipefetch["Recipe fetching<br/>[fetch_recipe.dart]"]
  node_recommendations["Recommendation builder"]
  node_fridgefetch["Fridge recipe fetch"]
  node_model["Ingredient model service"]
  node_firebase["Firebase configuration"]
  node_assets["Recipe and model assets"]
end

node_person(("App user"))

node_person -.->|"opens"| node_entry
node_entry -.->|"shows"| node_home
node_home -.->|"presents"| node_mealcard
node_mealcard -.->|"opens"| node_recipeview
node_fridgepick -.->|"selects items"| node_fridgerecipes
node_scan -.->|"identifies items"| node_model
node_fridgerecipes -.->|"requests recipes"| node_fridgefetch
node_home -.->|"requests picks"| node_recommendations
node_recommendations -.->|"gets recipes"| node_recipefetch
node_recipeview -.->|"shows details"| node_nutrition
node_person -.->|"signs in"| node_auth
node_person -.->|"registers"| node_register
node_auth -.->|"updates state"| node_authstate
node_person -.->|"sets preferences"| node_preferences
node_person -.->|"manages exclusions"| node_blacklist
node_recipefetch -.->|"returns recipe"| node_recipe
node_model -.->|"uses model"| node_assets

click node_entry "https://github.com/sifal2001/fait-maison/blob/main/lib/main.dart"
click node_home "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/home.dart"
click node_mealcard "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/meal_card.dart"
click node_recipeview "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/show_recipe.dart"
click node_fridgepick "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/from_fridge_item_picker.dart"
click node_fridgerecipes "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/show_from_fridge_recipes.dart"
click node_scan "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/scan_and_learn.dart"
click node_nutrition "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/show_nutrition.dart"
click node_auth "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/login.dart"
click node_register "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/register.dart"
click node_preferences "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/preferences.dart"
click node_blacklist "https://github.com/sifal2001/fait-maison/blob/main/lib/screens/black_list.dart"
click node_authstate "https://github.com/sifal2001/fait-maison/blob/main/lib/providers/auth_provider.dart"
click node_recipefetch "https://github.com/sifal2001/fait-maison/blob/main/lib/utilities/fetch_recipe.dart"
click node_recommendations "https://github.com/sifal2001/fait-maison/blob/main/lib/utilities/build_recommendations.dart"
click node_fridgefetch "https://github.com/sifal2001/fait-maison/blob/main/lib/utilities/fetch_recipe_from_fridge.dart"
click node_model "https://github.com/sifal2001/fait-maison/blob/main/lib/services/tflite_service.dart"
click node_firebase "https://github.com/sifal2001/fait-maison/blob/main/lib/firebase_options.dart"
click node_recipe "https://github.com/sifal2001/fait-maison/blob/main/lib/modals/recipe.dart"
click node_assets "https://github.com/sifal2001/fait-maison/tree/main/assets"

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_entry,node_home,node_mealcard,node_person toneBlue
class node_recipeview,node_fridgepick,node_fridgerecipes,node_scan,node_nutrition,node_recipe toneAmber
class node_auth,node_register,node_preferences,node_blacklist toneMint
class node_authstate,node_recipefetch,node_recommendations,node_fridgefetch,node_model,node_firebase,node_assets toneRose
```

## Components

### App and screens

- [App entry](https://github.com/sifal2001/fait-maison/blob/main/lib/main.dart): `lib/main.dart`
- [Home](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/home.dart): `lib/screens/home.dart`
- [Meal cards](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/meal_card.dart): `lib/screens/meal_card.dart`

### Recipe workflows

- [Recipe view](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/show_recipe.dart): `lib/screens/show_recipe.dart`
- [Fridge item picker](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/from_fridge_item_picker.dart): `lib/screens/from_fridge_item_picker.dart`
- [Fridge recipes](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/show_from_fridge_recipes.dart): `lib/screens/show_from_fridge_recipes.dart`
- [Scan and learn](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/scan_and_learn.dart): `lib/screens/scan_and_learn.dart`
- [Nutrition](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/show_nutrition.dart): `lib/screens/show_nutrition.dart`
- [Recipe data](https://github.com/sifal2001/fait-maison/blob/main/lib/modals/recipe.dart): `lib/modals/recipe.dart`

### User features

- [Authentication](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/login.dart): `lib/screens/login.dart`
- [Registration](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/register.dart): `lib/screens/register.dart`
- [Preferences](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/preferences.dart): `lib/screens/preferences.dart`
- [Recipe blacklist](https://github.com/sifal2001/fait-maison/blob/main/lib/screens/black_list.dart): `lib/screens/black_list.dart`

### Services and state

- [Auth state](https://github.com/sifal2001/fait-maison/blob/main/lib/providers/auth_provider.dart): `lib/providers/auth_provider.dart`
- [Recipe fetching](https://github.com/sifal2001/fait-maison/blob/main/lib/utilities/fetch_recipe.dart): `lib/utilities/fetch_recipe.dart`
- [Recommendation builder](https://github.com/sifal2001/fait-maison/blob/main/lib/utilities/build_recommendations.dart): `lib/utilities/build_recommendations.dart`
- [Fridge recipe fetch](https://github.com/sifal2001/fait-maison/blob/main/lib/utilities/fetch_recipe_from_fridge.dart): `lib/utilities/fetch_recipe_from_fridge.dart`
- [Ingredient model service](https://github.com/sifal2001/fait-maison/blob/main/lib/services/tflite_service.dart): `lib/services/tflite_service.dart`
- [Firebase configuration](https://github.com/sifal2001/fait-maison/blob/main/lib/firebase_options.dart): `lib/firebase_options.dart`
- [Recipe and model assets](https://github.com/sifal2001/fait-maison/tree/main/assets): `assets`

### Other components

- **App user**

## Connections

- App user → App entry: opens
- App entry → Home: shows
- Home → Meal cards: presents
- Meal cards → Recipe view: opens
- Fridge item picker → Fridge recipes: selects items
- Scan and learn → Ingredient model service: identifies items
- Fridge recipes → Fridge recipe fetch: requests recipes
- Home → Recommendation builder: requests picks
- Recommendation builder → Recipe fetching: gets recipes
- Recipe view → Nutrition: shows details
- App user → Authentication: signs in
- App user → Registration: registers
- Authentication → Auth state: updates state
- App user → Preferences: sets preferences
- App user → Recipe blacklist: manages exclusions
- Recipe fetching → Recipe data: returns recipe
- Ingredient model service → Recipe and model assets: uses model
