Skip to content

NickalasB/SimpleMealPlanner

Repository files navigation

Simple Meal Planner

Simple Meal Planner is an app created to solve a simple but persistant problem in most any family home... "What are we gonna make for dinner this week?"

The app allows users to search for recipes using ingredient or title keywords with a clean and simple UI.

Once a recipe is selected, users can either save the recipe as a personal favorite or save the recipe in a meal plan assigned to a specific day of the week. Once a user has saved a recipe to a meal plan it can easily be shared with any other registered users of the app. The recipient of a shared recipe will be notified on their device via a rich app notification.

The app is a work-in-progress with more features planned. It was built primarily as a solution to figuring out what to feed our teenage boys. I wanted a way to discover recipes and easily share them with my wife.

Enjoy!

Getting Started

Simple Meal Planner finds recipes using Edamam's Recipe Search API.

The app also uses a Firebase Realtime Database for storing recipes and Firebase Authentication to allow signing into the app via Gmail (needed to save and share recipes).

There are a few things you need to setup if you want to build and run the app locally.

  • First you need to sign up as an Edamam developer and obtain an App Id and App Key from Edamam's website
    • Once you have obtained an App Id and App Key from Edamam you'll need to add them to the projecet.
    • Create a new file at the top level of the project titled apikey.properties (Right-click on SimpleMealPlanner -> New -> File -> apikey.properties)
    • Next paste your appId and appKey values into that file with the following format:
EDAMAM_APP_ID="[YOUR APP_ID]"
EDAMAM_APP_KEY="[YOUR APP_KEY]"
  • Next you need to configure the app to use Firebase. Follow the directions found here
    • For the package name use com.zonkey.simplemealplanner
    • When you get to the "Add Firebase to your Android App" step, you will need to generate a Debug signing certificate SHA-1. Follow the steps here to obtain your signing certificate.
    • Once configured and added you need to set up your Realtime Database by selecting the following on the left-side of the portal: Develop -> Database -> Create database (under Realtime Database) -> Start in test mode
    • You also need to enable Google Authentication by selecting the following on the left-side of the portal: Authentication -> Sign-in method -> Google -> Enable

From there you should be able to sync, build, install, and enjoy all the features of the app. Enjoy

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published