A free and open source meal planner and recipe manager

View the demo · Report a bug · Request a feature · Ask questions

• About Meal Time

  • Purpose

• Features

• Who's it for?

• Getting Started

• Contributing

  • Development

• License

About Meal Time

Meal Time is a meal planning and recipe management application designed to simplify your culinary journey. Whether you're a seasoned chef or just getting started in the kitchen, Meal Time has an array of features to streamline your meal planning process.

Purpose

Meal Time aims to help you easily plan, organize, and execute your meals. Our goal is to make meal planning a breeze, enabling you to:

• Effortlessly create and manage meal plans.
• Manage recipes from various sources.
• Organize your recipes in collections for easy retrieval.
• Monitor and analyze your dietary choices.

Demo Video

Features

Meal Planner

• Plan your meals by day, week, or month with an intuitive calendar interface.
• Easily add recipes to your meal plan for each day.
• Get a nutritional breakdown of your meal plan to help you achieve your dietary goals.

Recipe Management

• Save and organize your favorite recipes in one place.
• Import recipes from external websites by simply pasting the link.
• View detailed information about each recipe, including nutritional data and upcoming schedules on your meal plan.

Collections

• Create custom collections to group recipes by cuisine, occasion, or any category you prefer.
• Organize your recipes efficiently, making it easy to find the perfect dish for any occasion.

Who's it for?

Meal Time is perfect for:

• Home cooks looking to simplify their meal planning process.
• Health-conscious individuals aiming to track their nutritional intake.
• Food enthusiasts who want to collect and organize their favorite recipes.
• Anyone interested in maintaining a well-structured meal schedule.

Getting Started

You can try out Meal Time through the demo site.

Contributing

Contributions are welcome. If you'd like to contribute, please follow these steps:

1. Fork the Meal Time repository on GitHub.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them with clear, concise messages.
4. Submit a pull request detailing your changes and the problem you're addressing.

Development

You can setup a development environment for Meal Time using docker and docker-compose.

Change your current working directory to the root of the project and run the following command first:

$ docker-compose run --rm start_dependencies

This will make sure the mysql server is up and running before the other services start.

Then you can start the rest of the services:

$ docker-compose up

If you are working on a specific service you can also start only that service and dependencies by running:

$ docker-compose up <service-name>
# for example:
$ docker-compose up api

License

Meal Time is open-source software released under the MIT License. You are free to use, modify, and distribute this software in accordance with the terms of the license. For more details, please refer to the LICENSE file.