MCPcopy
hub / github.com/mealie-recipes/mealie

github.com/mealie-recipes/mealie @v3.20.1 sqlite

repository ↗ · DeepWiki ↗ · release v3.20.1 ↗
4,837 symbols 21,784 edges 844 files 553 documented · 11%
README

Latest Release Contributors Stargazers Issues AGPL License Docker Pulls GHCR Pulls

Mealie

A Place For All Your Recipes



<a href="https://docs.mealie.io/"><strong>Explore the docs »</strong></a>

<a href="https://demo.mealie.io/">View Demo</a>
·
<a href="https://github.com/mealie-recipes/mealie/issues">Report Bug</a>
·
<a href="https://github.com/mealie-recipes/mealie/pkgs/container/mealie">GitHub Container Registry</a>

Product Name Screen Shot

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.

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.

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 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.

License

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

Sponsors

Huge thanks to all the sponsors of this project on Github Sponsors 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

Extension points exported contracts — how you extend this code

PageState (Interface)
* PageState encapsulates the state of the recipe page the can be shared across components. * It allows and facilitates
frontend/app/composables/recipe-page/shared-state.ts
FormSelectOption (Interface)
(no doc)
frontend/app/types/auto-forms.ts
FormFieldNumberInputConfig (Interface)
(no doc)
frontend/app/types/auto-forms.ts
FormField (Interface)
(no doc)
frontend/app/types/auto-forms.ts
GlobalComponents (Interface)
(no doc)
frontend/app/types/components.d.ts

Core symbols most depended-on inside this repo

random_string
called by 652
tests/utils/factories.py
json
called by 401
mealie/services/migrations/utils/migration_helpers.py
create
called by 332
mealie/repos/repository_units.py
page_all
called by 164
mealie/repos/repository_recipes.py
get_one
called by 162
mealie/routes/_base/mixins.py
t
called by 134
mealie/lang/providers.py
update
called by 128
mealie/db/models/users/users.py
uuid4
called by 101
frontend/app/composables/use-utils.ts

Shape

Function 1,857
Method 1,471
Class 848
Interface 365
Route 287
Enum 9

Languages

Python78%
TypeScript22%

Modules by API surface

frontend/app/lib/api/types/household.ts83 symbols
frontend/app/lib/api/types/recipe.ts80 symbols
tests/utils/api_routes/__init__.py78 symbols
tests/integration_tests/user_recipe_tests/test_recipe_crud.py57 symbols
mealie/routes/recipe/recipe_crud_routes.py52 symbols
tests/unit_tests/repository_tests/test_pagination.py50 symbols
mealie/schema/user/user.py43 symbols
mealie/repos/repository_factory.py43 symbols
mealie/services/scraper/scraper_strategies.py39 symbols
mealie/schema/recipe/recipe_ingredient.py39 symbols
mealie/schema/recipe/recipe.py38 symbols
mealie/routes/households/controller_shopping_lists.py38 symbols

Dependencies from manifests, versioned

@mdi/js7.4.47 · 1×
@nuxt/eslint1.2.0 · 1×
@nuxt/fonts0.11.4 · 1×
@nuxtjs/i18n9.2.1 · 1×
@playwright/test1.55.1 · 1×
@sphinxxxx/color-conversion2.2.2 · 1×
@stylistic/eslint-plugin5.4.0 · 1×
@types/node25.5.2 · 1×
@types/sortablejs1.15.8 · 1×
@vite-pwa/nuxt0.10.6 · 1×
@vitejs/plugin-vue6.0.7 · 1×
@vitest/coverage-v83.2.4 · 1×

Datastores touched

dbDatabase · 1 repos
mealieDatabase · 1 repos

For agents

$ claude mcp add mealie \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact