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
Find a file
Hayden ea7c4771ee
Feature/user photo storage (#877)
* add default assets for user profile

* add recipe avatar

* change user_id to UUID

* add profile image upload

* setup image cache keys

* cleanup tests and add image tests

* purge user data on delete

* new user repository tests

* add user_id validator for int -> UUID conversion

* delete depreciated route

* force set content type

* refactor tests to use temp directory

* validate parent exists before createing

* set user_id to correct type

* update instruction id

* reset primary key on migration
2021-12-18 19:04:36 -09:00
.github add LDAP Deps to build file 2021-11-26 12:16:08 -09:00
.vscode feat: Paprika/Mealie Migration support (#873) 2021-12-09 19:52:53 -09:00
dev Feature/user photo storage (#877) 2021-12-18 19:04:36 -09:00
docs feat: add user recipe export functionality (#845) 2021-12-04 14:18:46 -09:00
frontend Feature/user photo storage (#877) 2021-12-18 19:04:36 -09:00
mealie Feature/user photo storage (#877) 2021-12-18 19:04:36 -09:00
tests Feature/user photo storage (#877) 2021-12-18 19:04:36 -09:00
.dockerignore Feature/CRF++ and server side locales (#731) 2021-10-09 13:08:23 -08:00
.flake8 fix linters 2021-08-07 16:58:58 -08:00
.gitattributes v0.2.0 (#143) 2021-02-08 09:47:40 -09:00
.gitignore feat: Paprika/Mealie Migration support (#873) 2021-12-09 19:52:53 -09:00
.pylintrc Release v0.1.0 Candidate (#85) 2021-01-17 22:22:54 -09:00
Caddyfile Feature/user photo storage (#877) 2021-12-18 19:04:36 -09:00
crowdin.yml Crowdin integration (#319) 2021-04-20 07:28:18 -08:00
docker-compose.dev.yml add nightly CI/CD 2021-08-07 20:22:22 -08:00
docker-compose.yml fix sharing errors 2021-12-05 13:35:16 -09:00
Dockerfile add LDAP Deps to build file 2021-11-26 12:16:08 -09:00
gunicorn_conf.py use class for conf (#607) 2021-07-01 15:58:50 -08:00
LICENSE init 2 2020-12-24 16:37:38 -09:00
makefile feat(frontend): Rewrite context menu in TS and add 'add to mealplan' context menu action (#786) 2021-11-05 21:29:15 -08:00
netlify.toml test-docs ci/cd 2021-08-04 10:05:53 -08:00
poetry.lock chore(backend): ⬆️ bump recipe-scrapers and extruct 2021-11-26 12:00:02 -09:00
pyproject.toml chore(backend): ⬆️ bump recipe-scrapers and extruct 2021-11-26 12:00:02 -09:00
README.md refactor(♻️): update 'about' page to new composition API (#667) 2021-09-02 11:24:17 -08:00
runtime.txt test ci/cd 2021-08-04 09:58:51 -08:00
template.env fix(backend): 🐛 Grab PRs from dev branch (#826) 2021-11-23 20:41:07 -09:00
vetur.config.js reorganize all frontend items 2021-08-01 19:24:47 -08:00

Contributors Forks Stargazers Issues MIT License Docker Pulls CodeFactor Docker Build Production Project Tests Production Docker Build Dev Project Tests Dev


Mealie

A Place for All Your Recipes
Explore the docs »
View Demo · Report Bug · API · Request Feature · Docker Hub

Product Name Screen Shot

About The Project

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. Mealie also provides an API for interactions from 3rd party applications.

Remember to join the Discord!

Key Features

  • 🔍 Fuzzy search
  • 🏷️ Tag recipes with categories or tags for flexible sorting
  • 🕸 Import recipes from around the web by URL
  • 💪 Powerful bulk Category/Tag assignment
  • 📱 Beautiful Mobile Views
  • 📆 Create Meal Plans
  • 🛒 Generate shopping lists
  • 🐳 Easy setup with Docker
  • 🎨 Customize your interface with color themes
  • 💾 Export all your data in any format with Jinja2 Templates
  • 🔒 Keep your data safe with automated backup and easy restore options
  • 🌍 localized in many languages
  • Plus tons more!
    • Flexible API
      • Custom key/value pairs for recipes
      • Webhook support
      • Interactive API Documentation thanks to FastAPI and Swagger
    • Raw JSON Recipe Editor
    • Migration from other platforms
      • Chowdown
      • Nextcloud Cookbook
    • Random meal plan generation

FAQ

Why An API?

An API allows integration into applications like Home Assistant that can act as notification engines to provide custom notifications based of Meal Plan data to remind you to defrost the chicken, marinade the steak, or start the CrockPot. Additionally, you can access nearly any backend service via the API giving you total control to extend the application. To explore the API spin up your server and navigate to http://yourserver.com/docs for interactive API documentation.

Why a Database?

Some users of static-site generator applications like ChowDown have expressed concerns about their data being stuck in a database. Considering this is a new project it is a valid concern to be worried about your data. Mealie specifically addresses this concern by provided automatic daily backups that export your data in json, plain-text markdown files, and/or custom Jinja2 templates. This puts you in controls of how your data is represented when exported from Mealie, which means you can easily migrate to any other service provided Mealie doesn't work for you.

As to why we need a database?

  • Developer Experience: Without a database a lot of the work to maintain your data is taken on by the developer instead of a battle tested platform for storing data.
  • Multi User Support: With a solid database as backend storage for your data Mealie can better support multi-user sites and avoid read/write access errors when multiple actions are taken at the same time.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. Especially test. Literally any tests. See the Contributors Guide for help getting 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

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Project Link: https://github.com/hay-kot/mealie