Rust Recipe Manager

A lightning-fast, highly-customizable recipe manager built in Rust. It's designed to be a central hub for all your recipes with advanced features tailored specifically for home cooks and BBQ enthusiasts.

📸 Preview

Desktop Home	Integrated Timer
Mobile Experience	Smart Filtering (Mobile)

✨ Features

• Blazing Fast: Powered by Rust, Axum, and Askama templates for a near-instant user experience.
• Mobile Optimized UX:
  • Tabbed Interface: Switch seamlessly between Ingredients, Directions, and Cook Graphs on mobile devices.
  • No-Lock Cooking: Integrated Wake Lock API prevents your screen from locking while you cook.
  • Space Saving: Collapsible recipe photos and a streamlined header specifically for small screens.
• Integrated Cooking Timer:
  • Quick-Access: Floating timer panel accessible from any page with a single click.
  • Smart Suggestions: Automatically extracts durations from recipe prep/cook fields and directions for one-tap timer setting.
  • Multimedia Alerts: Looping alarm sound and pulsing visual header indicator when time is up.
  • Persistence: Triggers browser notifications to alert you even if you switch tabs.
• Advanced Multi-Tag Filtering:
  • Combinatorial Logic: Apply multiple tags simultaneously to narrow down your collection (AND logic).
  • Dynamic Tag Menu: The filter menu updates in real-time, only showing tags that exist within the currently filtered results—no more "Zero Results" filters.
  • Integrated Tag Search: Quickly find specific tags within your collection using the built-in search box inside the filter menu.
• Favorites System:
  • Quick Mark: Toggle favorites directly from recipe cards on the home screen or the recipe detail page.
  • Dedicated Filter: Instantly view your top recipes with a one-click "Favorites" filter.
  • Admin Security: Only the logged-in administrator can modify favorites, while guests can still view and filter by them.
• Dynamic Ingredient Scaling: Easily multiply recipe yields (e.g., 0.5x, 2x, 3x) with real-time updates directly in the text.
• Smart Unit Conversion: Seamlessly toggle entire recipes between Original, Metric, and Imperial systems (instantly converts measurements embedded within markdown text!).
• Baker's Percentage Mode: Automatically activated for recipes tagged with bread or dough. It calculates the total flour weight as 100% and displays all other ingredients as a relative percentage—essential for analyzing hydration levels and salt ratios.
• Combustion Inc. Integration: Upload Combustion Inc. predictive thermometer CSV exports directly to a recipe to visualize your cook's core, surface, and ambient temperatures over time with interactive Chart.js graphs.
• Fermentation Calculator: Intelligent tool for bread bakers. It automatically detects yeast or sourdough starter amounts in your ingredients and estimates proofing times based on your current kitchen temperature.
• YouTube Video Integration:
  • URL Import: Paste a YouTube link and the app will use Gemini AI to "watch" the video via its transcript and generate a full recipe.
  • Integrated Player: Watch the original video directly inside a dedicated tab in the recipe view—perfect for following along on mobile.
• Smart Import from Anywhere:
  • URL Import: Automatically scrape recipes from URLs using LD+JSON or a robust Gemini AI fallback for sites without structured data.
  • Paprika Import: Bulk import archives (.paprikarecipes) from Paprika Recipe Manager.
  • AI Photo Import: Take a photo of a cookbook page, and the built-in Gemini AI Vision integration will automatically extract the title, ingredients, and instructions!
• Cooking Temperatures & Safety:
  • Meat Temp Reference: A dedicated reference page for internal meat temperatures and doneness levels, covering everything from rare steak to low & slow BBQ brisket.
  • USDA Log 7 Calculator: Interactive calculator for poultry safety. Achieve perfectly juicy chicken at lower temperatures by calculating the required hold time for safe Salmonella lethality.
• Secure Admin Login: Protect your recipes from unauthorized edits or imports. Set an ADMIN_PASSWORD_HASH environment variable to restrict modifying actions to yourself while keeping the site read-only for guests.
• Developer-Friendly API: Comprehensive REST API (v1) for programmatic recipe management, enabling future mobile app integrations or custom automation workflows.
• Multi-Select Shopping List:
  • Select multiple recipes from the home page.
  • Automatically scale all selected recipes to your desired number of portions.
  • Combine and convert all ingredients into a unified list (Metric or Imperial).
• Streamlined UI & Aesthetics:
  • Minimalist Header: Clean, icon-only navigation bar that provides more screen real estate for your content.

---

🔌 API Documentation

The application includes a RESTful API (v1) that allows for programmatic access to your recipes, making it easy to build mobile apps or integrations.

Base URL: /api/v1

Endpoint	Method	Description
/recipes	GET	List all recipes (includes hydration summaries).
/recipes	POST	Create a new recipe (Requires API_TOKEN).
/recipes/{id}	GET	Get a specific recipe with unit/scale conversion and automatic hydration calculation.
/recipes/{id}	PUT	Update an existing recipe (Requires API_TOKEN).
/recipes/{id}	DELETE	Delete a recipe (Requires API_TOKEN).
/temps	GET	Get a list of recommended internal meat temperatures.
/log7	GET	Calculate USDA Log 7 hold time for safe poultry lethality based on temp.
/ferment	GET	Calculate estimated fermentation time based on type, amount, and temp.
/import	POST	Import a recipe from a URL using AI processing (Requires API_TOKEN).
/shopping-list	POST	Generate a combined, scaled shopping list from multiple recipes.

📖 Interactive API Guide

The application features a built-in interactive API guide accessible at /api. It provides detailed documentation for every endpoint and an interactive "Try it out" playground that allows you to test the API directly from your browser.

Authentication: For mutable operations (POST, PUT, DELETE, IMPORT), you must provide an API_TOKEN in the Authorization header as a Bearer token. Set this token using the API_TOKEN environment variable.

---

🔐 Generating an Admin Password Hash

To secure your recipe manager, you need to set the ADMIN_PASSWORD_HASH environment variable. This prevents anyone else from editing or importing recipes.

You can generate this hash using the included utility script:

If you have Rust installed locally:

cargo run --bin hash_password "my_secure_password"

If you are using Docker:

docker run --rm dnewsholme/recipemanager:latest ./hash_password "my_secure_password"

Copy the output (e.g., $2y$12$...) and use it as the value for ADMIN_PASSWORD_HASH when starting your server.

---

🚀 Running Locally (Development)

Environment Variables:

• ADMIN_PASSWORD_HASH: Required for secure login. See the section above to generate your hash. If omitted, the default temporary password is "admin".
• API_TOKEN: (Required for API write access) A secure token for authenticating API requests.
• SESSION_SECRET: (Optional but recommended) A long random string used to cryptographically sign session cookies. If omitted, sessions will reset every time the server restarts.
• GEMINI_API_KEY: Required if you want to use the AI Photo Import or Video URL Import features. You can get a free key from Google AI Studio.
• APP_BASE: (Optional) Set this if you are hosting the app behind a reverse proxy on a subpath (e.g. APP_BASE="/recipes").

To run locally:

1. Ensure you have Rust and Cargo installed.
2. Run the following:

# Clone the repository
git clone https://github.com/dnewsholme/recipemanager.git
cd recipemanager

# Run the server locally
export ADMIN_PASSWORD_HASH='<your_generated_hash>'
export API_TOKEN='your_api_token_here'
export SESSION_SECRET='your_random_secret_string'
export GEMINI_API_KEY="your_api_key_here"
cargo run

The application will be available at http://localhost:3000.

---

🐳 Running with Docker (Production)

The application is containerized using a multi-stage Docker build, resulting in an incredibly small and secure runtime image.

The easiest way to run the application is via Docker. Be sure to map a volume to /app/data to ensure your recipes and uploaded images persist across container restarts.

docker run -d \
  --name recipemanager \
  -p 3000:3000 \
  -e ADMIN_PASSWORD_HASH='<your_generated_hash>' \
  -e API_TOKEN='your_api_token_here' \
  -e SESSION_SECRET='your_random_secret_string' \
  -e GEMINI_API_KEY="your_api_key_here" \
  -v /path/to/your/local/data:/app/data \
  dnewsholme/recipemanager:latest

Data Directory Structure

The /app/data volume contains two critical subdirectories:

• recipes/: Contains the markdown files (.md) representing your saved recipes.
• uploads/: Contains any images or Combustion CSV files you have uploaded.

---