Meal Recipe is a modern Android application built with Jetpack Compose, Retrofit, and Room. It helps users discover delicious meals by category (like Chicken, Pork, etc.), view full meal details, and save their favorite meals for offline access. It also includes a powerful search feature and a clean, Material 3-inspired UI.
- Browse meals by categories like Chicken, Pork, Seafood, etc.
- On clicking a category, the app fetches and shows meals under it.
- Each meal has a detailed screen showing:
- Instructions to cook
- Ingredients
- YouTube video tutorial
- Source and category
- Data fetched using Retrofit from TheMealDB API
- Save your favorite meals for offline viewing using Room database.
- Access all saved meals in the Saved section, even without internet.
- Long press a saved meal to delete it via an alert dialog.
- Use the dropdown menu to Clear All saved meals at once.
- Search meals by name.
- Clicking a search result opens the full meal details.
- You can also save from the search result screen.
- Built with Jetpack Compose & Material 3
- Lottie animations and beautiful gradients
- Light/Dark theme support
- 💻 Kotlin
- 🎨 Jetpack Compose
- 🔌 Retrofit
- 🗂️ Room
- 🧪 ViewModel + StateFlow
- 🧑🎨 Google Stitch UI for UI
- MVVM (Model-View-ViewModel)
- Clean separation of concerns
- Retrofit used for API calls
- Room used for local storage
- State management with
StateFlowand Compose’sstatesystem
(Add screenshots of your app here — Category Screen, Meal Detail Screen, Saved Meals, Search)
###Home Screen/Category Screen
This screen recording demonstrates the category navigation feature of the application. Users can browse various food categories such as chicken, beef, and more. Selecting a category displays dishes specific to that category. When a dish is chosen, detailed information appears—including the recipe ingredients, step-by-step instructions, and a YouTube source link for reference. This flow highlights how users can easily explore and discover new recipes within the app.
CategoryScreen.mp4
##Per Dish Details Screen
This screen recording demonstrates the user journey within the application. It starts with the main category selection, where users can choose from options such as chicken, beef, and more. After selecting a category, the app displays related food dishes. When a specific dish is chosen, the detailed view provides the recipe ingredients, step-by-step preparation instructions, and a source link to a YouTube video for additional guidance. This recording highlights the smooth navigation between categories and food details, offering users an easy way to discover and prepare new recipes.
PerFoodDetailsScreen.mp4
The following screen recording demonstrates the main user flow of the app. Users start by selecting a food category (e.g., chicken, beef, etc.), which leads to a list of relevant dishes. Upon choosing a dish, the detailed view provides complete ingredient lists, step-by-step instructions, and an embedded YouTube source link for further guidance. This recording showcases the app’s streamlined navigation, intuitive interface, and comprehensive recipe presentation.
search_screen.mp4
this screen contains dummy data no data in this screeen is Real
This screen recording demonstrates the app’s main user flow: browsing recipe categories such as chicken and beef, viewing dishes specific to each category, and exploring detailed information for a selected dish. The detail view includes ingredients, step-by-step instructions, and a YouTube source link for preparation guidance, highlighting the app’s easy navigation and comprehensive recipe presentation.
savedScreen.mp4
git clone https://github.com/yourusername/meal-explorer.git
Add these permissions to your AndroidManifest.xml:
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>