# yohalmoechegoyen46-max/recipebox architecture

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

- Interactive diagram: https://gitdiagram.com/yohalmoechegoyen46-max/recipebox
- Repository: https://github.com/yohalmoechegoyen46-max/recipebox

## Overview

RecipeBox is an Android recipe app, with screens for exploring recipes, viewing details, managing favorites, and maintaining a shopping list. The apparent workflow begins at the app entry point and branches into those user tasks, backed by repositories and local storage; a remote recipe API is also represented. The supplied excerpts contain no app source and the README is empty, so screen-to-view-model and data-layer connections below are dashed, unverified relationships inferred from the file tree rather than confirmed calls.

Main entry points: [`app/src/main/java/com/example/data/repository/RecipeRepository.kt`](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/repository/RecipeRepository.kt) (Recipe repository), [`app/src/main/java/com/example/ui/screens/explore/ExploreScreen.kt`](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/explore/ExploreScreen.kt) (Explore screen), [`app/src/main/java/com/example/ui/components/BottomNavBar.kt`](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/components/BottomNavBar.kt) (Bottom navigation), [`app/src/main/java/com/example/ui/viewmodel/FavoritesViewModel.kt`](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/FavoritesViewModel.kt) (Favorites state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_ui["App and UI"]
  node_main_activity["App entry<br/>[MainActivity.kt]"]
  node_bottom_nav["Bottom navigation<br/>[BottomNavBar.kt]"]
end

subgraph group_recipe_flow["Recipe browsing"]
  node_explore_screen["Explore screen<br/>[ExploreScreen.kt]"]
  node_explore_vm["Explore state"]
  node_category_filter["Category filters"]
  node_recipe_card["Recipe card<br/>[RecipeCard.kt]"]
  node_detail_screen["Recipe details"]
  node_detail_vm["Detail state<br/>[DetailViewModel.kt]"]
end

subgraph group_saved_shopping["Saved and shopping"]
  node_favorites_screen["Favorites screen<br/>[FavoritesScreen.kt]"]
  node_favorites_vm["Favorites state"]
  node_shopping_screen["Shopping list"]
  node_shopping_vm["Shopping state"]
end

subgraph group_data_layer["Data and storage"]
  node_recipe_model["Recipe model<br/>[Recipe.kt]"]
  node_recipe_seed["Recipe seed data<br/>[RecipeSeedData.kt]"]
  node_recipe_repo["Recipe repository"]
  node_shopping_repo["Shopping repository"]
  node_database[("Local database<br/>[AppDatabase.kt]")]
  node_favorite_dao["Favorites access<br/>[FavoriteDao.kt]"]
  node_favorite_entity["Favorite record"]
  node_shopping_dao["Shopping access<br/>[ShoppingDao.kt]"]
  node_shopping_entity["Shopping record"]
  node_recipe_api["Recipe API"]
  node_retrofit["HTTP client setup<br/>[RetrofitClient.kt]"]
end

node_user(("User"))
node_remote_service(("Remote service"))

node_user -.->|"opens"| node_main_activity
node_main_activity -.->|"shows"| node_bottom_nav
node_bottom_nav -.->|"navigates"| node_explore_screen
node_bottom_nav -.->|"navigates"| node_favorites_screen
node_bottom_nav -.->|"navigates"| node_shopping_screen
node_explore_screen -.->|"uses state"| node_explore_vm
node_explore_screen -.->|"shows"| node_category_filter
node_explore_screen -.->|"shows"| node_recipe_card
node_explore_screen -.->|"opens recipe"| node_detail_screen
node_detail_screen -.->|"uses state"| node_detail_vm
node_explore_vm -.->|"loads recipes"| node_recipe_repo
node_detail_vm -.->|"loads recipe"| node_recipe_repo
node_favorites_screen -.->|"uses state"| node_favorites_vm
node_favorites_vm -.->|"manages favorites"| node_recipe_repo
node_shopping_screen -.->|"uses state"| node_shopping_vm
node_shopping_vm -.->|"manages items"| node_shopping_repo
node_recipe_repo -.->|"reads seed data"| node_recipe_seed
node_recipe_repo -.->|"uses model"| node_recipe_model
node_shopping_repo -.->|"accesses items"| node_shopping_dao
node_shopping_dao -.->|"uses storage"| node_database
node_shopping_dao -.->|"stores records"| node_shopping_entity
node_favorites_vm -.->|"accesses favorites"| node_favorite_dao
node_favorite_dao -.->|"uses storage"| node_database
node_favorite_dao -.->|"stores records"| node_favorite_entity
node_recipe_repo -.->|"requests recipes"| node_recipe_api
node_recipe_api -.->|"uses client"| node_retrofit
node_retrofit -.->|"connects to"| node_remote_service

click node_main_activity "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/recipebox/MainActivity.kt"
click node_bottom_nav "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/components/BottomNavBar.kt"
click node_explore_screen "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/explore/ExploreScreen.kt"
click node_explore_vm "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/ExploreViewModel.kt"
click node_category_filter "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/components/CategoryFilterChips.kt"
click node_recipe_card "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/components/RecipeCard.kt"
click node_detail_screen "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/detail/RecipeDetailScreen.kt"
click node_detail_vm "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/DetailViewModel.kt"
click node_favorites_screen "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/favorites/FavoritesScreen.kt"
click node_favorites_vm "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/FavoritesViewModel.kt"
click node_shopping_screen "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/shopping/ShoppingListScreen.kt"
click node_shopping_vm "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/ShoppingViewModel.kt"
click node_recipe_model "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/model/Recipe.kt"
click node_recipe_seed "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/model/RecipeSeedData.kt"
click node_recipe_repo "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/repository/RecipeRepository.kt"
click node_shopping_repo "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/repository/ShoppingRepository.kt"
click node_database "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/AppDatabase.kt"
click node_favorite_dao "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/dao/FavoriteDao.kt"
click node_favorite_entity "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/entity/FavoriteRecipeEntity.kt"
click node_shopping_dao "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/dao/ShoppingDao.kt"
click node_shopping_entity "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/entity/ShoppingItemEntity.kt"
click node_recipe_api "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/remote/RecipeApiService.kt"
click node_retrofit "https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/remote/RetrofitClient.kt"

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_main_activity,node_bottom_nav,node_user toneBlue
class node_explore_screen,node_explore_vm,node_category_filter,node_recipe_card,node_detail_screen,node_detail_vm toneAmber
class node_favorites_screen,node_favorites_vm,node_shopping_screen,node_shopping_vm toneMint
class node_recipe_model,node_recipe_seed,node_recipe_repo,node_shopping_repo,node_database,node_favorite_dao,node_favorite_entity,node_shopping_dao,node_shopping_entity,node_recipe_api,node_retrofit toneRose
class node_remote_service toneIndigo
```

## Components

### App and UI

- [App entry](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/recipebox/MainActivity.kt): `app/src/main/java/com/example/recipebox/MainActivity.kt`
- [Bottom navigation](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/components/BottomNavBar.kt): `app/src/main/java/com/example/ui/components/BottomNavBar.kt`

### Recipe browsing

- [Explore screen](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/explore/ExploreScreen.kt): `app/src/main/java/com/example/ui/screens/explore/ExploreScreen.kt`
- [Explore state](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/ExploreViewModel.kt): `app/src/main/java/com/example/ui/viewmodel/ExploreViewModel.kt`
- [Category filters](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/components/CategoryFilterChips.kt): `app/src/main/java/com/example/ui/components/CategoryFilterChips.kt`
- [Recipe card](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/components/RecipeCard.kt): `app/src/main/java/com/example/ui/components/RecipeCard.kt`
- [Recipe details](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/detail/RecipeDetailScreen.kt): `app/src/main/java/com/example/ui/screens/detail/RecipeDetailScreen.kt`
- [Detail state](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/DetailViewModel.kt): `app/src/main/java/com/example/ui/viewmodel/DetailViewModel.kt`

### Saved and shopping

- [Favorites screen](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/favorites/FavoritesScreen.kt): `app/src/main/java/com/example/ui/screens/favorites/FavoritesScreen.kt`
- [Favorites state](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/FavoritesViewModel.kt): `app/src/main/java/com/example/ui/viewmodel/FavoritesViewModel.kt`
- [Shopping list](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/screens/shopping/ShoppingListScreen.kt): `app/src/main/java/com/example/ui/screens/shopping/ShoppingListScreen.kt`
- [Shopping state](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/ui/viewmodel/ShoppingViewModel.kt): `app/src/main/java/com/example/ui/viewmodel/ShoppingViewModel.kt`

### Data and storage

- [Recipe model](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/model/Recipe.kt): `app/src/main/java/com/example/data/model/Recipe.kt`
- [Recipe seed data](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/model/RecipeSeedData.kt): `app/src/main/java/com/example/data/model/RecipeSeedData.kt`
- [Recipe repository](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/repository/RecipeRepository.kt): `app/src/main/java/com/example/data/repository/RecipeRepository.kt`
- [Shopping repository](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/repository/ShoppingRepository.kt): `app/src/main/java/com/example/data/repository/ShoppingRepository.kt`
- [Local database](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/AppDatabase.kt): `app/src/main/java/com/example/data/local/AppDatabase.kt`
- [Favorites access](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/dao/FavoriteDao.kt): `app/src/main/java/com/example/data/local/dao/FavoriteDao.kt`
- [Favorite record](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/entity/FavoriteRecipeEntity.kt): `app/src/main/java/com/example/data/local/entity/FavoriteRecipeEntity.kt`
- [Shopping access](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/dao/ShoppingDao.kt): `app/src/main/java/com/example/data/local/dao/ShoppingDao.kt`
- [Shopping record](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/local/entity/ShoppingItemEntity.kt): `app/src/main/java/com/example/data/local/entity/ShoppingItemEntity.kt`
- [Recipe API](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/remote/RecipeApiService.kt): `app/src/main/java/com/example/data/remote/RecipeApiService.kt`
- [HTTP client setup](https://github.com/yohalmoechegoyen46-max/recipebox/blob/main/app/src/main/java/com/example/data/remote/RetrofitClient.kt): `app/src/main/java/com/example/data/remote/RetrofitClient.kt`

### Other components

- **User**
- **Remote service**

## Connections

- User → App entry: opens
- App entry → Bottom navigation: shows
- Bottom navigation → Explore screen: navigates
- Bottom navigation → Favorites screen: navigates
- Bottom navigation → Shopping list: navigates
- Explore screen → Explore state: uses state
- Explore screen → Category filters: shows
- Explore screen → Recipe card: shows
- Explore screen → Recipe details: opens recipe
- Recipe details → Detail state: uses state
- Explore state → Recipe repository: loads recipes
- Detail state → Recipe repository: loads recipe
- Favorites screen → Favorites state: uses state
- Favorites state → Recipe repository: manages favorites
- Shopping list → Shopping state: uses state
- Shopping state → Shopping repository: manages items
- Recipe repository → Recipe seed data: reads seed data
- Recipe repository → Recipe model: uses model
- Shopping repository → Shopping access: accesses items
- Shopping access → Local database: uses storage
- Shopping access → Shopping record: stores records
- Favorites state → Favorites access: accesses favorites
- Favorites access → Local database: uses storage
- Favorites access → Favorite record: stores records
- Recipe repository → Recipe API: requests recipes
- Recipe API → HTTP client setup: uses client
- HTTP client setup → Remote service: connects to
