Tandoor 2 is a complete re-write of Tandoors frontend in Vue 3 using vuetify as a UI library. While the core concepts remain unchanged, everything has been rewritten to be faster, easier to use and better looking.
Generally Tandoor 2
- is a lot faster by using more efficient JavaScript and better component splitting
- more stable by using TypeScript and higher quality frontend modules to prevent annoying and undescriptive errors
- better optimized for mobile and smaller devices by having custom workflows/UI's for certain operations
- looking better thanks to the extensive component library combined with many custom components
- easy to use and expand by having a standard framework for the editors of recipes, foods, meal plans and all other models
- a very strong foundation for future development by creating the framework needed to add new features faster and easier
- fixes lots of smaller and larger bugs from Tandoor 1
Some noteworthy highlights are
- AI Recipe import to import pictures and PDF recipes (see temporary docs)
- A global search to search for and open recipes on every page
- A new start page to discover recipes and quickly manage meal plans
- The ability to manually add entries to the shopping list linked with meal plans for better organization/context
- url bindings to the search and on some other pages, so navigating back and forward feels a lot better
- Individual pages for all model edit pages to make them linkable
- Quick edit function for the property editor to make it easier to identify and fix missing properties or conversions
- Warnings when leaving/closing editors about unsaved changes
- improved settings parsing (thanks to fliiiix #3161)
đ API Changes
- added improved ical endpoint on meal plan api (thanks to c0mputerguru #3038)
- changed revisited all API endpoints and added universal pagination, schemas and test/documentation improvements (thanks to @smilerz #3068 #3123 #3126 #3143)
- changed renamed API endpoints
food-propertyandfood-property-typetopropertyandproperty-type(thanks to @smilerz #3131) - changed API endpoints
/space//space/now returns all spaces a user has access to/space/current/returns the currently active space infocreated_byno returned as object not user id
- changed Recipe API endpoint to use default formats instead of prefixed ones to indicate >= or <=
- affected parameters: rating, timescooked, createdon, updatedon, cookedon, viewedon
- changed
last_autosyncparameter of ShoppingListEntry endpoint is nowupdated_after - changed ingredient from string api to return food and unit as objects and create them if not present
- removed old log_cooking, plan-ical and backup API endpoints (thanks to @smilerz #3123)
- removed some special/duplicate parameters from ShoppingListEntry endpoint
- various other smaller changes and additions to filters and response fields
đģ Install
Tandoor 2 is still in alpha and does not offer all features you might be used to from Tandoor 1. See the Tandoor 2 Project to evaluate the development progress. That said, I have personally been using Tandoor 2 exclusively for several month and am no longer missing much/experiencing many issues.
You can install it by switching your image to vabene1111/recipes:feature-vue3/ghcr.io/tandoorrecipes/recipes:feature-vue3 to always get the latest version or to the tagged released for the alpha versions. Please keep in mind that things can and will break during the alpha so you should probably use the tagged releases and not auto update.
âšī¸ Compatibility Note
This release of Tandoor 2 does not have any changes to the database. This means it is possible to switch between Tandoor 1 and Tandoor 2 freely at any point. This will likely stay this way until most features have been ported and a majority of users has started to use the new version.
There are some minor incompatibilities to note:
- loading a Tandoor 1 saved search filter and saving it in Tandoor 2 to then again load and use it in Tandoor 1 might lead to unexpected results. If the filter is just used in Tandoor 2 but not saved nothing changes.
- API Changes mentioned above
- There are no longer docker images for
arm/v7at this point. It is simply too much work for me to maintain a working build for this platform at the moment. This might change in the future and you are still free to build your own image.
â¤ī¸ Support Tandoor
The development of Tandoor 2 started in January of 2024. Since then hundreds if not thousands of hours of work have been put into building the foundation for Tandoors future. This has exclusively been done by myself in my spare time.
It is always hard for me to divide my time between my job that keeps the lights on, my family, serving as a voluntary firefighter and tandoor but the countless heart-warming stories of people using Tandoor have always motivated me to continue this project. If you want to help in supporting this undertaking consider sponsoring this project.