Fork Recipes

Fork Recipes is a simple, elegant frontend web application built with Django to manage personal food recipe collections. It is designed to work alongside the ForkApi backend and provides media-rich recipe management, meal planning, printing and backup tools.

Key Features

• Django 5.x Python frontend with HTML/CSS/JS UI and Docker/docker-compose deployment
• Postgres database support and preconfigured SSL/NoSSL options
• Create and organize recipes with images or video, categories and favorite flag
• Meal planning scheduler and shopping list integration for ingredients
• Print-ready recipe layouts (compact and extended) and exportable backup snapshots
• Smart utilities that integrate with external AI services: recipe scraper, generate-by-ingredients, translation, and audio narration (these features require an OpenAI API token)
• Import/export and apply database snapshots for backup/restore workflows

Use Cases

• Home cooks who want a searchable, media-rich personal recipe collection with meal planning
• Small kitchens or producers that need printable recipes and centralized media for menus or training
• Users who want to scrape or generate recipe variations, translate recipes, or add narrated steps via external AI services

Limitations and Considerations

• Many smart features (scraper, recipe generation, translation, audio narration) require an external OpenAI API token and are not available offline
• The frontend is intended to work with the ForkApi backend; deploying without a compatible API may limit functionality
• Audio narration is English-only as provided by the integrated service and scraper compatibility varies by target website

Fork Recipes is focused on a clean, media-first recipe management experience with practical features for planning, printing and backups. It is optimized for containerized deployment and integrates optional AI-powered utilities when API credentials are provided.