Recet is an open source, work in progress recipe manager application built using Nuxt and SurrealDB. It is motivated from personal needs and the curiosity to see how much functionality can be squeezed out from using SurrealDB as the backend. My goal is to create a web app that feels great on both desktop and mobile using modern technologies like PWA, View Transition API, all while showcasing many features of SurrealDB.
I plan to create the following modules:
- Authentication ✅
- Households ✅
- Master data managment ✅
- Recipes ✅
- Shopping lists ✅
- Meal planner ✅
- Recipe import from websites or text ✅
- Recipe AI ❌
- Mobile ✅
- PWA ✅
- View Transitions ✅
- Dark Mode ✅
✅ - Working 👷♀️ - Work in progress ❌ - Coming later
![]() |
![]() |
The project uses Nuxt.js and SurrealDB. It needs a DB instance running with the structure defined in db.surql.
The project uses two currently experimental features:
- files: for this to work the
SURREAL_BUCKET_FOLDER_ALLOWLISTenv var has to be set - surrealism: the
recet.surliplugin in thesurreal-plugindirectory has to be copied into thepluginsbucket's directory
These experimental features are available in the v3 versions of SurrealDB.
- clone the repo
- pnpm i
- pnpm run dev
- it should be running on port 3000
It looks for the database at 'http://localhost:8000' by default, but this can be changed with the NUXT_PUBLIC_SURREAL_DB_URL enviroment variable.


