A beautiful self-hosted recipe manager for your family / friend group.
The setup is quick and easy: just follow the Installation Guide.
Check out all the pictures in the docs/screenshots folder!
Each user can manage any number of cookbooks for himself, which may contain many recipes.
Recipes can take shape as...
- a link (leading to some recipe website's page)
- ingredients + instructions
- recipe images (photos taken from a physical cookbook)
... and have food pictures uploaded for it.
There can also be multiple tags associated with a recipe (like "vegetarian" or "gluten-free"). Individual colors can be picked on the tags page.
A searchbar and a tag filter in the header enable quick and easy browsing of recipes by specific criteria.
There is a planner, where a user can switch between calendar weeks and manage recipes that he wants to prepare on specific days (for breakfast, lunch, dinner or as a snack in between).
Sorting is implemented for almost all entities, to give the user the freedom of (re)arranging his data.
By default, the app is "multi-tenant" (each user only sees their own data) and the only special privilege of admins is to manage users.
However, users can make their cookbooks editable by others ("community") or just viewable ("public").
Users can upload a profile picture to personalize their account.
Recipes have a comment section where users can discuss them. A notifications feed keeps users informed about new comments and activity.
The application supports multiple languages (currently German and English). Each user can choose their preferred language in their settings.
Uploaded images are automatically optimized. They are resized into multiple versions, scaled down, converted to WebP, compressed, efficiently served and cached.
Images on the recipe detail page open in a zoomable and swipeable lightbox for a better viewing experience.
The app uses:
- a Docker Compose setup based on the official Docker+Laravel setup example
- with PHP 8.4
- Laravel 12
- Livewire 4
- using the Laravel Livewire Starter Kit
- Flux UI 2 incl. Pro Components
- Tailwind CSS 4
- PhotoSwipe 5 (image lightbox library)
The below database diagram shows the data model of the application.
This project is actively maintained by me.
For questions or support, just email me.
See the Contribution Guide and the Developer Docs.