Latest Release: v1.0.0
Direct Download: QuickBites-v1.0.0.apk
- Download the APK file from the link above
- On your Android device, go to Settings > Security
- Enable Install from Unknown Sources (if not already enabled)
- Open the downloaded APK file
- Tap Install and follow the prompts
- Open QuickBites and start discovering recipes!
System Requirements:
- Android 5.0 (Lollipop) or higher
- ~10 MB storage space
- Internet connection for recipe search
Note
This is an unsigned APK. Your device may show a warning, which is normal for apps not from the Play Store.
QuickBites solves a universal problem: "What should I cook?"
Instead of staring at your fridge wondering what to make, simply input your available ingredients and QuickBites instantly suggests recipes you can prepare right now. With a smart mood-based filter, real recipe images, and thousands of options powered by TheMealDB API, meal planning has never been easier.
Perfect for:
- Busy professionals with limited time
- College students learning to cook
- Anyone looking to reduce food waste
- Home cooks seeking inspiration
- Intelligent Ingredient Search - Type what you have, discover what you can make
- Mood-Based Filtering - Choose between Fast, Healthy, Comfort, or Mix recipes
- Real Recipe Images - Professional food photography for every dish
- Smart Favorites System - Save and quickly access your preferred recipes
- Advanced Search - Filter favorites by name, ingredients, or category
- Integrated Grocery List - Auto-generate shopping lists from recipes
- Social Sharing - Share recipes and lists via any messaging app
- Live API Integration - Access to 1000+ recipes from TheMealDB
- Offline Capability - Favorites stored locally for offline access
- Modern Material Design - Clean, intuitive user interface
- Optimized Performance - Fast loading with image caching
- Real-time Updates - Dynamic content loading with progress indicators
Search for recipes by typing ingredients and selecting your mood with the slider.
Browse through recipe suggestions with beautiful images from TheMealDB API.
View complete recipe information including ingredients, cooking time, and step-by-step instructions.
- Android Studio Hedgehog (2023.1.1) or newer
- JDK 11 or higher
- Android SDK 36
- Minimum Android device: API 21 (Lollipop 5.0)
# Clone the repository
git clone https://github.com/divineib/QuickBites.git
# Navigate to project directory
cd QuickBites
# Open in Android Studio
# File > Open > Select QuickBites folder
# Sync Gradle (Android Studio will prompt)
# Wait for dependencies to download
# Run the app
# Click Run button or press Shift+F10
# Select your device/emulator# In Android Studio
Build > Build Bundle(s) / APK(s) > Build APK(s)
# APK will be generated in:
app/build/outputs/apk/debug/app-debug.apk- Java - Primary development language
- Android SDK - Native Android development
- Material Design - UI/UX framework
- MVP Architecture - Clean separation of concerns
- Repository Pattern - Data access abstraction
- Observer Pattern - Reactive UI updates
Retrofit 2.9.0 // REST API client
OkHttp 4.12.0 // HTTP client
Gson 2.10.1 // JSON parsingGlide 4.16.0 // Image loading and caching
Material Components // Modern UI components
RecyclerView // Efficient list rendering
CardView // Material card designSQLite // Local database for favorites
SharedPreferences // App settings storage- TheMealDB API - Recipe data and images (Free tier)
- 1000+ recipes with detailed instructions
- High-quality food photography
- Searchable by ingredient, name, category
- No API key required
QuickBites/
├── app/src/main/
│ ├── java/com/example/quickbites/
│ │ ├── MainActivity.java # Home screen with search
│ │ ├── RecipeListActivity.java # Display search results
│ │ ├── RecipeDetailsActivity.java # Full recipe view
│ │ ├── FavoritesActivity.java # Saved recipes
│ │ ├── GroceryListActivity.java # Shopping list
│ │ │
│ │ ├── adapters/
│ │ │ ├── RecipeAdapter.java # RecyclerView adapter for recipes
│ │ │ └── GroceryAdapter.java # RecyclerView adapter for list items
│ │ │
│ │ ├── models/
│ │ │ ├── Recipe.java # Recipe data model
│ │ │ └── GroceryItem.java # Grocery item model
│ │ │
│ │ ├── api/
│ │ │ ├── MealApiService.java # Retrofit API interface
│ │ │ ├── MealApiResponse.java # API response models
│ │ │ ├── RetrofitClient.java # Singleton Retrofit instance
│ │ │ └── ApiHelper.java # API data transformation
│ │ │
│ │ └── database/
│ │ └── DatabaseHelper.java # SQLite database manager
│ │
│ └── res/
│ ├── layout/ # XML layouts
│ ├── drawable/ # Icons and graphics
│ ├── values/ # Strings, colors, themes
│ └── mipmap/ # App icons
│
├── screenshots/ # App screenshots
├── gradle/ # Gradle configuration
├── README.md # This file
└── .gitignore # Git ignore rules
User Input → MainActivity
↓
Search Query → RetrofitClient → TheMealDB API
↓
MealApiResponse → ApiHelper (Data Transformation)
↓
Recipe Objects → RecipeAdapter → RecyclerView
↓
User Selection → RecipeDetailsActivity
↓
Save to Favorites → DatabaseHelper → SQLite
- Searches TheMealDB API by primary ingredient
- Filters results based on mood preference
- Caches images for offline viewing
- Stores recipe IDs locally in SQLite
- Fetches full recipe data from API on demand
- Enables offline access to saved recipes
- Analyzes recipe categories and cooking times
- Auto-categorizes as Fast, Healthy, Comfort, or Mix
- Provides personalized meal suggestions
- Meal planning calendar with weekly view
- Nutritional information and calorie tracking
- User-generated recipe uploads
- Recipe ratings and reviews system
- Advanced filters (cuisine, dietary restrictions)
- Voice-activated ingredient input
- Barcode scanner for pantry management
- AI-powered recipe recommendations
- Social features (follow friends, share meal plans)
- Integration with grocery delivery services
- Dark mode support
- Premium tier with unlimited custom recipes
- Partnership with grocery retailers
- Affiliate marketing for cooking equipment
- Ad-free subscription option
- Search recipes by ingredient
- Filter by mood (Fast, Healthy, Comfort, Mix)
- Add/remove favorites
- Search within favorites
- Add items to grocery list
- Share recipes and lists
- Handle network errors gracefully
- Load images efficiently
# Test ingredient search
Input: "chicken"
Expected: Display 10+ chicken recipes with images
# Test mood filter
Input: "healthy" mood selected
Expected: Show only healthy-categorized recipes
# Test favorites
Action: Toggle heart icon
Expected: Recipe persists in Favorites screen
# Test offline mode
Action: Disable internet, open Favorites
Expected: Previously favorited recipes still accessibleContributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Follow existing code style and conventions
- Add comments for complex logic
- Test thoroughly before submitting PR
- Update README if adding new features
This project is licensed under the MIT License - see the LICENSE file for details.
Divine Ibeawuchi
Software Engineering Student
- TheMealDB - For providing the comprehensive recipe API
- Material Design - For UI/UX design guidelines
- Android Community - For extensive documentation and support
- Glide Team - For the efficient image loading library
If you encounter any issues or have questions:
- Open an Issue: GitHub Issues
- Discussions: GitHub Discussions
If you find QuickBites helpful, please consider giving it a star on GitHub!
Made with care for people who love good food but hate meal planning