mealie-recipes / mealie

Mealie is a self hosted recipe manager and meal planner with a RestAPI backend and a reactive frontend application built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the url and mealie will automatically import the relevant data or add a family recipe with the UI editor
https://docs.mealie.io
GNU Affero General Public License v3.0
5.59k stars 608 forks source link
hacktoberfest hacktoberfest2022 meal-plans recipe-manager self-hosted

[![Latest Release][latest-release-shield]][latest-release-url] [![Contributors][contributors-shield]][contributors-url] [![Stargazers][stars-shield]][stars-url] [![Issues][issues-shield]][issues-url] [![AGPL License][license-shield]][license-url] [![Docker Pulls][docker-pull]][docker-url] [![GHCR Pulls][ghcr-pulls]][ghcr-url]


Mealie

A Place For All Your Recipes
Explore the docs »
View Demo · Report Bug · GitHub Container Registry

[![Product Name Screen Shot][product-screenshot]](https://docs.mealie.io) # About The Project Mealie is a self hosted recipe manager, meal planner and shopping list with a RestAPI backend and a reactive frontend built in Vue for a pleasant user experience for the whole family. Easily add recipes into your database by providing the URL and Mealie will automatically import the relevant data, or add a family recipe with the UI editor. Mealie also provides an API for interactions from 3rd party applications. - [Remember to join the Discord](https://discord.gg/QuStdQGSGK)! - [Documentation](https://docs.mealie.io/) ## Key Features - Recipe imports: Create recipes, by **importing from a URL** or entering data manually - Meal Planner: Use the **Meal Planner** to plan your what you'll cook for the next week - Shopping List: Put the necessary ingredients on your **Shopping List**, organised into sections of your local supermarket - Cookbooks: Group recipes into **Cookbooks** based on your own criteria - Docker: Easy **Docker** deployment - Localisation: **Translations** for 35+ languages ## Contributing Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**. If you're going to be working on the code-base, you'll want to use the nightly documentation to ensure you get the latest information. - See the [Contributors Guide](https://nightly.mealie.io/contributors/developers-guide/code-contributions/) for help getting started. - We use [VSCode Dev Containers](https://code.visualstudio.com/docs/remote/containers) to make it easy for contributors to get started! If you are not a coder, you can still contribute financially. Financial contributions help me prioritize working on this project over others and helps me know that there is a real demand for project development. Buy Me A Coffee ### Translations Translations can be a great way for **non-coders** to contribute to the project. We use [Crowdin](https://crowdin.com/project/mealie) to allow several contributors to work on translating Mealie. You can simply help by voting for your preferred translations, or even by completely translating Mealie into a new language. For more information, check out the translation page on the [contributor's guide](https://nightly.mealie.io/contributors/translating/). ## License Distributed under the AGPL License. See `LICENSE` for more information. ## Sponsors Huge thanks to all the sponsors of this project on [Github Sponsors](https://github.com/sponsors/hay-kot) and Buy Me a Coffee. Without you, this project would surely not be possible. Thanks to Depot for providing build instances for our Docker image builds. [![Built with Depot](https://depot.dev/badges/built-with-depot.svg)](https://depot.dev?utm_source=Mealie) [contributors-shield]: https://img.shields.io/github/contributors/mealie-recipes/mealie.svg?style=flat-square [docker-pull]: https://img.shields.io/docker/pulls/hkotel/mealie?style=flat-square [docker-url]: https://hub.docker.com/r/hkotel/mealie [ghcr-pulls]: https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fipitio%2Fghcr-pulls%2Fmaster%2Findex.json&query=%24%5B%3F(%40.owner%3D%3D%22mealie-recipes%22%20%26%26%20%40.repo%3D%3D%22mealie%22%20%26%26%20%40.image%3D%3D%22mealie%22)%5D.pulls&style=flat-square&label=ghcr%20pulls [ghcr-url]: https://github.com/mealie-recipes/mealie/pkgs/container/mealie [contributors-url]: https://github.com/mealie-recipes/mealie/graphs/contributors [stars-shield]: https://img.shields.io/github/stars/mealie-recipes/mealie.svg?style=flat-square [stars-url]: https://github.com/mealie-recipes/mealie/stargazers [issues-shield]: https://img.shields.io/github/issues/mealie-recipes/mealie.svg?style=flat-square [issues-url]: https://github.com/mealie-recipes/mealie/issues [latest-release-shield]: https://img.shields.io/github/v/release/mealie-recipes/mealie?style=flat-square&label=latest%20release [latest-release-url]: https://github.com/mealie-recipes/mealie/releases [license-shield]: https://img.shields.io/github/license/mealie-recipes/mealie.svg?style=flat-square [license-url]: https://github.com/mealie-recipes/mealie/blob/mealie-next/LICENSE [linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square&logo=linkedin&colorB=555 [linkedin-url]: https://linkedin.com/in/hay-kot [product-screenshot]: docs/docs/assets/img/home_screenshot.png