Recipya Rust

A clean, simple and powerful recipe manager your whole family will enjoy.

Website • Demo • Matrix

Table of Contents

• Features
• Installation
• Migrating from Recipya (Go version)
• Contributing
• AI Disclaimer
• Sponsors
• Roadmap
• Inspiration

Features

• Manage your favorite recipes
• Import recipes from around the web
• Digitize paper recipes
• Organize your recipes into cookbooks
• Works seamlessly with Nextcloud Cookbook
• Automatic conversion to your preferred measurement system (imperial/metric)
• Calculate nutritional information automatically
• Print any recipe in your collection
• Prevent your device from going to sleep while viewing a recipe
• Follows your system's theme (light/dark)
• Cross-compiled for Windows, Linux, and macOS

Installation

The software can be installed using either Docker or Podman. Please consult the installation guide for details.

Quick start

1. Fetch the docker-compose.yml file:

mkdir recipya-rs-compose && cd recipya-rs-compose
wget https://raw.githubusercontent.com/reaper47/recipya-rs/refs/heads/main/deploy/docker-compose.yml 

1. Fetch and review the .env configuration file:

wget -O .env https://raw.githubusercontent.com/reaper47/recipya-rs/refs/heads/main/deploy/.env.example 

1. Start the services

docker compose up -d

Migrating from Recipya (Go version)

If you want to migrate your Recipya Go data over to Recipya Rust, please follow the migration guide.

Quick summary

1. Update Recipya Go: Update your Docker image tag to nightly, then pull and restart the container.
2. Access the app: Open your Recipya Go web interface
3. Export data: Go to Settings → Data and download your data export as JSON.
4. Import data: From the Recipya Rust interface, click Add recipe → Import → Software, select the Recipya application, and upload your archive.

Contributing

Please consult the contribution guide for details on how you can contribute to the project.

AI Disclosure

What is there to be proud of if your project is generated by AI? You didn't write your art. The machine did.

Recipya is a project where AI is used sparingly. And when it is used, it serves as a rubber duck, a research tool, a debugging assistant and sometimes a guide on idiomatic Rust. I never ran an agent like Claude Code and Codex. All features were designed and planned by hand or thought of in the shower. The database was entirely designed on paper to see the relationships between tables. Some features, such as the shopping list one, contact, and SMS are also entirely planned on paper before coding.

Functions that were entirely generated by AI have an // AI usage: comment. This usually happens when I don't know the domain of what I'm trying to solve enough. The Bananacat (the mascot) and the default recipe image were generated using ComfyUI. It would one day be great if a non-AI mascot could be created using Inkscape.

I want Recipya to stay human and avoid becoming unmaintainable slop.

Sponsors

I am grateful for any support that motivates me to continue developing this project and to host it reliably.

You can sponsor me on GitHub Sponsors or Buy Me a Coffee.

Your support is greatly appreciated! A third of donations will be sent to the Armed Forces of Ukraine.

This project is supported by these kind people:

Roadmap

Please consult the roadmap document for details.

Inspiration

This project was mainly coded to blasting the following albums:

• 1914 - Viribus Unitis
• 4am
• Abysmal Dawn - Phylogenesis
• Archspire - Bleed the Future
• Archspire - Too Fast to Die
• Astralborne - Eternity's End
• Atavistia - Cosmic Warfare
• Beast In Black - Dark Connection
• Cattle Decapitation - Terrasite
• Desoration - NON
• Ensiferum - From Afar
• Fires in the Distance - Echoes From Deep November
• Kalmah - Swamplord
• Lofi Girl - lofi hip hop radio
• Lofi Girl - synthwave radio
• Mozart - Requiem Dm
• Necrophobic - In the Twilight Grey
• Pain - You Only Live Twice
• Sonata Arctica - Talviyö
• Wintersun - Wintersun
• Wintersun - Time I & II