github mealie-recipes/mealie v2.0.0
v2.0.0 - Households and much more!

15 hours ago

🍴🍴🍴🍴🍴🍴

We've got some big changes here as part of our v2.0 release!

Before getting into that, we wanted to take this milestone occasion to ask for your support in taking a few minutes to complete a survey that will help us gauge how our users actually use Mealie. We have no telemetry of any kind built into the product, so without your input we don't really know how you use it!
You can complete the survey at https://s.surveyplanet.com/00x4a2o0
We'd be very appreciative of your time.

Moving onto the main event.. please do read the whole list of changes!

🎉 Highlights

🏡 Households

The introduction of Households is one of Mealie's most requested features and a huge technical change. The implementation of it touched 300+ files and 10k+ lines of code.

A household is a subdivision of groups with a collection of users. While groups can be considered as completely separate instances, households mix their data with each other. Another way to think of a household is a family: your group may contain different families, each with their own shopping lists, meal plans, and recipes.

These previously group-level features now belong to a household:

  • Notifiers
  • Webhooks
  • Cookbooks
  • Recipe Actions
  • Users
  • Shopping Lists
  • Meal Plans and Meal Plan Rules
  • Recipes

Of note, these features are not tied to a household, and are shared amongst households:

  • Organizers (Tags, Categories, Tools)
  • Ingredient Stores (Foods, Units, Labels)

While recipes now belong to their respective households, within a group, all users can browse all recipes from all households. This means you can still favorite, filter, comment, and "make" all recipes within the group. Each household can configure whether or not they want their recipes to be view-only, or be editable by any user from any household. More information in the docs.

Read a detailed explanation in the main pull request, or a bit higher level explanation in the docs.

🔍 Query Filter Builder

Michael has built a new query builder to allow you to more granularly and intelligently setup rules for cookbooks and meal plans.
Read more detail in the pull request.

🛒 Shopping List UI Improvements

The shopping list has received many minor tweaks to make it more user friendly. With more on the way too!

🔐 OpenID Connect

With our v2 release coming up, there was a chance to make some large changes to the OIDC implementation to build on the learnings since its initial implementation. Thanks Carter!

More detail in the pull request and the docs, which includes a migration guide.

🚨 Breaking changes

More details can be found on each PR. Most of these will only be breaking changes for people who are doing custom work with our APIs, and shouldn't impact someone who is just using Mealie as is.

✨ New features

🐛 Bug fixes

🧰 Maintenance

52 changes

📚 Documentation

🔨 Internal development

⬆️ Dependency updates

91 changes

🙏 New Contributors

🍴🍴🍴🍴🍴🍴

Don't miss a new mealie release

NewReleases is sending notifications on new releases.