Skip to content

aar0gya/Meal-Mate

Repository files navigation

Meal Mate 🍽️

Meal Mate is an Android application designed to simplify meal planning, recipe creation, and grocery management.
Built using Java, Android Studio, and Firebase, it enables users to create weekly meal plans, manage groceries, and share shopping tasks with others — all through a clean, intuitive interface.


📱 Features

  • User Authentication (Firebase Email/Password)
  • Meal Planning with weekly and daily views
  • Recipe Management (create, edit, view)
  • Grocery List Management with real-time syncing
  • Geo-Tagging and Location Services (Google Maps SDK + Geocoder)
  • Meal Notifications using Android AlarmManager
  • Image Uploads via Firebase Storage and Imgur API
  • Real-Time Synchronization with Firestore
  • Profile Management with user avatars and editable info
  • Delegation and Sharing via SMS/Contacts

⚙️ Tech Stack

Component Technology
Frontend Java (Android SDK), Material Design
Backend Firebase Firestore, Firebase Authentication, Firebase Storage
External APIs Google Maps SDK, Imgur API
IDE Android Studio
Design Tools Figma, draw.io
Testing Tools JUnit, Mockito, Espresso, Firebase Emulator

🧩 Architecture

  • MVVM pattern with modular activities and fragments
  • Firestore listeners (addSnapshotListener()) for real-time updates
  • RecyclerView adapters for recipe and grocery list views
  • Seamless synchronization of user data across devices

🧠 Testing Summary

Type Tools Scope Result
Unit Tests JUnit, Mockito Core logic (auth, CRUD, reminders) ✅ Pass
Integration Firebase Emulator Firestore and Authentication ✅ Pass
UI Tests Espresso User interaction and navigation ✅ Pass
Performance Android Profiler Startup and scrolling ✅ Pass
UAT Manual Overall usability ✅ Pass

📊 Future Enhancements

  • Offline caching support for meal and grocery data
  • Dark mode and improved UI animations
  • Cross-platform support (Flutter/React Native)
  • Smart meal recommendations using ML models
  • Advanced nutritional analytics (Spoonacular/Edamam APIs)
  • Social integration for recipe sharing

📸 Screens & Design

  • Wireframed using Figma
  • Hierarchical structure designed in draw.io
  • Key screens:
    • Splash, Login, Signup, Dashboard
    • Meal Plan, Grocery List, Recipe Manager
    • Map-based Store Locator and Delegation System

🧾 License

This project is licensed under the MIT License — see LICENSE for details.


💡 Author

Developed by Aarogya Bikram Thapa


About

Meal Mate — A smart Android meal planner and grocery management app built using Java and Firebase. Create meal plans, manage recipes, track groceries, and geo-tag stores — all in one intuitive app.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages