Zur App
Offizielle Dokumentation (CookVegan PRD)

CookVegan 🌱 Benutzerhandbuch

Vollständige Anleitung für die pflanzliche Rezeptverwaltung. Erfahren Sie alles über das 3-Stufen-Cloud-Modell, den Web-Rezept-Import, die dynamische Portionenskalierung mit Bruchzahlen, den ablenkungsfreien Koch-Modus und die smarte Einkaufsliste.

1. Übersicht & Vision

CookVegan (de.wodniok.cookvegan) ist eine moderne, adaptive Cross-Plattform-Applikation (iOS, iPadOS, Android, macOS Desktop und Web), die speziell für das Entdecken, Strukturieren, Teilen und Kochen veganer Rezepte entwickelt wurde.

Die App zeichnet sich durch ein ansprechendes Botanical Sage Design, kompromisslose Ausfallsicherheit durch Cloud-Synchronisation (Firebase Firestore & Auth) und praktische Küchenwerkzeuge aus.

🌱 Optimiert für jedes Endgerät

Egal ob auf dem iPhone in der Hosentasche, im iPad Split-View auf der Küchentheke oder auf dem Mac-Desktop beim Wochenplan: Das adaptive Interface passt sich optimal an die Bildschirmgröße an.

2. Das 3-Stufen Cloud- & Sharing-Modell

In CookVegan haben Sie jederzeit die volle Kontrolle darüber, wer Ihre Rezepte einsehen darf:

🔒

Privat (Private Vault)

Das Rezept ist in Ihrem persönlichen Cloud-Tresor gespeichert. Ausschließlich Sie als authentifizierter Autor können das Rezept sehen, durchsuchen, bearbeiten oder löschen.

👥

Geteilt (Shared with Me)

Teilen Sie Rezepte gezielt mit Freunden, Partnern oder Familienmitgliedern über deren E-Mail-Adresse oder User-ID. Eingeladene Personen können das Rezept live einsehen, mitkochen und in ihre Einkaufsliste übernehmen.

🌍

Öffentlich (Community Public)

Veröffentlichen Sie Ihre besten Kreationen für die gesamte CookVegan-Community. Alle Nutzer können das Rezept im öffentlichen Feed entdecken und nachkochen.

🛡️ Autorenschutz durch Sicherheitsregeln

Die Cloud-Sicherheitsregeln (firestore.rules) stellen sicher, dass nur der ursprüngliche Autor Änderungen oder Löschungen an einem Rezept vornehmen kann.

3. Rezeptverwaltung & Vegane Nährwertanalyse

Jedes Rezept in CookVegan bietet eine umfassende Datenstruktur:

  • Metadaten: Titel, Beschreibung, ansprechendes Titelbild, Vorbereitungszeit, Kochzeit, Gesamtdauer, Schwierigkeitsgrad (Leicht, Mittel, Schwer).
  • Kategorien & Tags: High-Protein, Glutenfrei, Schnelle Küche (Quick & Easy), Meal-Prep, Comfort Food.
  • Allergene & Hinweise: Nüsse, Soja, Gluten, Sesam, Lupine etc.
  • Vollständige Nährwert-Aufschlüsselung pro Portion:
    • Kalorien (kcal), Protein (g), Kohlenhydrate (g), Fett (g), Ballaststoffe (g)
    • Vegane Mikronährstoffe: Vitamin B12 (µg), Eisen (mg), Calcium (mg)

4. Dynamischer Portionen- & Bruchzahlen-Skalierer

Passen Sie die Portionsanzahl mit den + / - Buttons flexibel an – CookVegan rechnet alle Mengenangaben und Nährwerte in Echtzeit um:

½

Echte Küchen-Bruchzahlen

Statt unhandlicher Dezimalzahlen (wie 0.33 oder 1.25) formatiert CookVegan Mengenangaben sauber als gebräuchliche Küchenbrüche wie ⅓ TL, ½ EL oder 1 ¼ Tassen.

⚖️

Metrische Einheiten & Nährwert-Skalierung

Gramm-, Milliliter- und Stückangaben sowie die Makronährstoffsummen passen sich exakt an die gewünschte Gäste- oder Familienanzahl an.

5. Smarter Web-Rezept-Importer

Übernehmen Sie Lieblingsrezepte aus dem Internet ohne manuelles Abtippen:

1

Rezept-URL kopieren & einfügen

Kopieren Sie den Link eines beliebigen Foodblogs oder einer Rezeptseite und fügen Sie ihn in den Importer-Tab ein.

2

Automatisches JSON-LD Parsing

CookVegan analysiert den Quelltext über standardisierte schema.org/Recipe Metadaten und extrahiert Titel, Zutatenliste, Zubereitungsschritte und Bild automatisch.

3

Live-Vorschau & Speichern

Prüfen Sie das importierte Rezept in der Live-Vorschau, passen Sie bei Bedarf Details an und speichern Sie es direkt in Ihrem privaten Tresor.

📝 Manueller Text-Parser

Haben Sie ein Rezept als reinen Text oder E-Mail vorliegen? Über den Reiter Text-Import können Sie den Text einfügen – CookVegan teilt ihn automatisch in Zutaten und Schritte auf.

6. Hands-Free Koch-Modus (Cook Mode)

Für die bequeme Zubereitung direkt an der Küchentheke:

📱

Große, ablenkungsfreie Schrittansicht

Keine störenden Menüs oder Werbebanner – der Koch-Modus konzentriert sich ganz auf den aktuellen Zubereitungsschritt und den Fortschrittsbalken.

⏱️

Integrierte Küchentimer mit Signalton

Erkennt der Schritt eine Zeitangabe (z. B. „15 Minuten köcheln lassen“), wird direkt ein Countdown-Timer bereitgestellt. Mit Start, Pause, Reset und einer +1 Min Taste für schnelles Nachjustieren.

7. Smarte Einkaufsliste & Supermarkt-Gänge

Organisieren Sie Ihren Einkauf stressfrei:

  1. Tippen Sie in einem Rezept auf „Zur Einkaufsliste hinzufügen“.
  2. Wählen Sie die gewünschte Portionsgröße aus.
  3. CookVegan sortiert alle Zutaten automatisch nach typischen Supermarkt-Gängen:
    • 🥦 Obst & Gemüse (Produce)
    • 🧊 Kühlregal, Tofu & Pflanzendrinks (Refrigerated)
    • 🌾 Getreide, Nudeln & Hülsenfrüchte (Grains & Legumes)
    • 🥫 Vorratskammer & Saucen (Pantry)
    • 🧂 Gewürze & Kräuter (Spices)
  4. Beim Einkaufen haken Sie erledigte Artikel per Fingertipp ab. Ein Klick auf „Erledigte löschen“ räumt die Liste auf.

8. Internationalisierung (DE / EN)

CookVegan ist vollständig zweisprachig lokalisiert:

  • Deutsch (`de-DE`) und Englisch (`en-US`).
  • Umschaltung direkt in den App-Einstellungen oder über das Sprachauswahl-Menü.
  • Die gewählte Spracheinstellung wird dauerhaft gespeichert und synchronisiert.

9. Häufige Fragen & Praxistipps

Funktioniert CookVegan auch offline?

Ja! Bereits geladene Rezepte und Ihre Einkaufsliste werden lokal im Gerätespeicher vorgehalten, sodass Sie auch ohne Empfang im Supermarkt Zugriff haben.

Kann ich ein Rezept nachträglich von Privat auf Geteilt umstellen?

Ja, über das Teilen-Symbol (Share Dialog) im Rezept können Sie jederzeit weitere E-Mail-Adressen hinzufügen oder das Rezept für die Community freigeben.

Welche Webseiten werden vom Importer unterstützt?

Nahezu alle modernen Foodblogs, Kochplattformen und Magazinseiten, die das standardisierte schema.org/Recipe JSON-LD Format verwenden.