🌿 CannaGuide 2025 (English)

The Definitive AI-Powered Cannabis Cultivation Companion

CannaGuide 2025 is your definitive AI-powered digital co-pilot for the entire cannabis cultivation lifecycle. Engineered for both novice enthusiasts and master growers, this state-of-the-art Progressive Web App (PWA) guides you from seed selection to a perfectly cured harvest. Simulate grows with an advanced VPD-based engine, explore a vast library of over 500 strains with a powerful genealogy tracker, diagnose plant issues with a photo, breed new genetics in the lab, plan equipment with Gemini-powered intelligence, and master your craft with an interactive, data-driven guide.

---

Table of Contents

• ⭐ Project Philosophy
• 🚀 Key Features
• 💻 Technical Deep Dive
• 🏁 Getting Started (User Guide)
• 🛠️ Installation & Local Development (Developer Guide)
• 🤔 Troubleshooting
• 🔒 Security
• 🤖 Development with AI Studio & Open Source
• 🤝 Contributing
• ⚠️ Disclaimer
• Deutsche Version

---

⭐ Project Philosophy

CannaGuide 2025 is built upon a set of core principles designed to deliver a best-in-class experience:

Offline First: Your garden doesn't stop when your internet does. The app is engineered to be 100% functional offline, ensuring you always have access to your data and tools.

Performance is Key: A fluid, responsive UI is non-negotiable. Heavy lifting, like the complex plant simulation, is offloaded to a Web Worker to keep the interface smooth and instantaneous.

Data Sovereignty: Your data is yours. The ability to export and import your entire application state gives you complete control, ownership, and peace of mind.

AI as a Co-pilot: We leverage AI not as a gimmick, but as a powerful tool to provide actionable, context-aware insights that truly assist the grower at every stage.

---

🚀 Key Features

1. The Grow Room (Plants View)

Your command center for managing and simulating up to three simultaneous grows.

• Advanced Simulation Engine: Experience a state-of-the-art simulation based on VPD (Vapor Pressure Deficit), biomass-scaled resource consumption, and a structural growth model.
• Toggleable UI Modes: Switch between a streamlined Simple Mode for core actions and an Expert Mode in the header to reveal detailed scientific data like VPD and DLI.
• AI-Powered Diagnostics:
  • Photo Diagnosis: Upload a photo of your plant to get an instant AI-based diagnosis, complete with immediate actions, long-term solutions, and preventative advice.
  • Proactive Advisor: Get data-driven advice from Gemini AI based on your plant's real-time vitals. All recommendations can be archived with full CRUD functionality.
• Comprehensive Logging: Track every action—from watering and feeding to training and pest control—in a detailed, filterable journal for each plant.
• Post-Harvest Simulation: Manage the critical Drying & Curing phases with a dedicated interface that tracks humidity, burping schedules, and chemical changes to achieve the perfect final product.

2. The Strain Encyclopedia (Strains View)

Your central knowledge hub, designed for deep exploration with offline-first access.

• Vast Library: Access detailed information on over 500 cannabis strains.
• Interactive Genealogy Tree: Visualize the complete genetic lineage of any strain. Use analysis tools to highlight landraces, trace Sativa/Indica parentage, calculate the genetic influence of top ancestors, and discover known descendants.
• High-Performance Search & Filtering: Instantly find strains with an IndexedDB-powered full-text search, alphabetical filtering, and an advanced multi-select filter drawer for THC/CBD range, flowering time, aroma, and more.
• Personal Strain Collection: Enjoy full CRUD (Create, Read, Update, Delete) functionality to add and manage your own custom strains.
• AI Grow Tips: Generate unique, AI-powered cultivation advice for any strain based on your experience level and goals, complete with a generated image, then manage it in a dedicated "Tips" archive.
• Flexible Data Export: Export your selected or filtered strain lists in multiple formats, including PDF, CSV, JSON, TXT, and XML.

3. The Workshop (Equipment View)

Your toolkit for planning and optimizing your grow setup.

• AI Setup Configurator: A streamlined 2-step process where you select your plant count and budget style (Value, Balanced, or Premium) to receive a complete, brand-specific equipment list generated by Gemini AI.
• Saved Setups: Full CRUD functionality for your generated equipment lists. Edit, delete, and manage your setups for future use.
• Suite of Calculators: Access a comprehensive set of precision tools:
  • Ventilation Calculator (m³/h)
  • Light Calculator (PPFD/DLI & Wattage)
  • Electricity Cost Calculator
  • Nutrient Mix Calculator
  • EC/PPM Converter
  • Yield Estimator
• Curated Shop Lists: Browse recommended Grow Shops and Seedbanks for both European and US/Canadian markets.

4. The Library (Knowledge & Help Views)

Your complete resource for learning and problem-solving.

• Context-Aware AI Mentor: Ask growing questions to the AI Mentor, which leverages your active plant's data for tailored advice. All conversations are archived with full CRUD support.
• Breeding Lab: Cross your high-quality collected seeds to create entirely new, permanent hybrid strains that are added to your personal library and can be used in future grows.
• Interactive Sandbox: Run "what-if" scenarios, like comparing Topping vs. LST on a clone of your plant, to visualize the impact of different training techniques over an accelerated simulation without risking your real plants.
• Comprehensive Guides: Access a built-in grower's lexicon, visual guides for common techniques, an extensive searchable FAQ, and a new, detailed User Manual explaining every feature of the app.

5. Platform-Wide Features

• Full PWA & Offline Capability: Install the app on your device for a native-like experience. The robust Service Worker ensures 100% offline functionality, including access to all data and AI archives.
• Command Palette (Cmd/Ctrl + K): A power-user tool for instant, click-free navigation and actions across the entire application.
• Complete Data Sovereignty: Export all your app data (plants, settings, archives, custom strains) to a single JSON file for backup. Import it later to restore your state on any device.
• Advanced Accessibility: Features a Dyslexia-Friendly Font, Reduced Motion mode, and integrated Text-to-Speech (TTS) functionality for key content.

---

💻 Technical Deep Dive

CannaGuide 2025 is built on a modern, robust, and scalable tech stack designed for performance and offline-first reliability.

• Frontend Framework: React 19 with TypeScript for a modern, type-safe, and performant user interface.
• State Management: Redux Toolkit (^2.2) serves as the single source of truth, ensuring predictable state transitions and simplifying debugging.
• Asynchronous Operations & AI:
  • RTK Query manages all interactions with the Google Gemini API (@google/genai ^1.19), providing caching and streamlined state management. The gemini-2.5-flash model is used for its optimal balance of speed, cost, and structured JSON output capabilities.
  • The plant growth simulation runs in a dedicated Web Worker, ensuring the main UI thread remains responsive and smooth.
• Data Persistence: A robust IndexedDB strategy ensures complete offline availability.
  • The core Redux state is persisted via a listener middleware, providing seamless state hydration and migration on app startup.
  • Large static assets, such as the strain library and search index, are managed in a separate IndexedDB database for optimal performance.
• PWA & Offline Capability: A Service Worker implements a "Cache First, then Network" strategy, making the application fully installable and functional without an internet connection.
• Styling: Tailwind CSS (via CDN) enables a rapid, utility-first approach to building a consistent and responsive design system, configured directly in index.html.

---

🏁 Getting Started (User Guide)

No installation is required beyond a modern web browser.

1. Onboarding: On first launch, you'll be guided through a quick tutorial to set your preferred language.
2. Discover Strains: Start in the Strains view. Use the search and filters to find a strain and save it as a favorite by clicking the heart icon.
3. Start Growing: Navigate to the Plants dashboard. From an empty slot, click "Start New Grow," select a strain from your favorites or the main list, and configure your setup.
4. Manage Your Grow: The Plants dashboard is your command center. Log actions like watering and feeding, check on your plant's vitals, and get advice from the AI.
5. Use the Command Palette: For the fastest access, press Cmd/Ctrl + K to navigate or perform actions instantly.

---

🛠️ Installation & Local Development (Developer Guide)

To run CannaGuide 2025 locally for development, follow these steps.

Prerequisites

• Node.js (v18.x or later recommended)
• npm (usually included with Node.js)
• A Google Gemini API Key. You can obtain one from Google AI Studio.

Installation

1. Clone the repository:

   git clone https://github.com/qnbs/CannaGuide-2025.git
   cd CannaGuide-2025

2. Install dependencies:

   npm install

3. Set up environment variables: The application requires a Google Gemini API key to function. Create a .env file in the root of the project:

   touch .env

   Open the .env file and add your API key:

   API_KEY=YOUR_GEMINI_API_KEY
   

   Note: This setup assumes a development environment that injects environment variables (like Vite or Create React App). The application code directly accesses process.env.API_KEY.

4. Run the application: This project is designed to run within Google's AI Studio, which handles the development server. If running locally, you would typically use a command like:

   npm start 

   (Note: package.json does not contain this script; you would need to add it or use a local server.)

Build Process

To create a production-ready build, you would typically run:

npm run build

This command would bundle and optimize the code, preparing it for deployment. (Note: package.json does not contain this script.)

---

🤔 Troubleshooting

• AI Features Not Working: This is almost always due to a missing or invalid Gemini API key. Ensure your .env file is correctly set up and the key is valid. Check your browser's developer console for any 4xx errors related to the Google API.
• App Not Updating (PWA Caching): If you've made changes but don't see them, the Service Worker might be serving a cached version.
  1. Open your browser's developer tools.
  2. Go to the Application tab.
  3. Find Service Workers, check "Update on reload", and click "Unregister" for the CannaGuide service worker.
  4. Go to Storage, click "Clear site data".
  5. Refresh the page.
• Data Corruption: If the application state becomes corrupted, you can perform a hard reset by navigating to Settings > Data Management > Reset All App Data. Warning: This will delete all your local data.

---

🔒 Security

• API Key Management: Your Gemini API key is a secret. Do not commit your .env file or expose the key in client-side code that is publicly accessible. The .gitignore file should include .env.
• Dependencies: Regularly check for vulnerabilities in the project's dependencies by running:

  npm audit

  Keep packages updated to their latest stable versions to mitigate security risks.

---

🤖 Development with AI Studio & Open Source

This application was developed entirely with Google's AI Studio. The entire process, from the initial project scaffolding to implementing complex features like the Redux state management and the Web Worker simulation, was driven by iterative prompts in natural language.

This project is also fully open source. Dive into the code, fork the project, or contribute on GitHub. See firsthand how natural language can build sophisticated applications.

• Fork the project in AI Studio: https://ai.studio/apps/drive/1_F6ArMCdXQt-1fWzTf0R6Sgge9lXxz4-
• View the source code on GitHub: https://github.com/qnbs/CannaGuide-2025

---

🤝 Contributing

We welcome contributions from the community! Whether you want to fix a bug, add a new feature, or improve translations, your help is appreciated.

1. Reporting Issues: If you find a bug or have an idea, please open an issue on GitHub first to discuss it.
2. Making Changes:
   • Fork the repository.
   • Create a new branch for your feature or bugfix (git checkout -b feature/my-new-feature).
   • Commit your changes (git commit -am 'Add some feature').
   • Push to the branch (git push origin feature/my-new-feature).
   • Create a new Pull Request.

Please follow the existing code style and ensure your changes are well-documented.

---

⚠️ Disclaimer

All information in this app is for educational and entertainment purposes only. The cultivation of cannabis is subject to strict legal regulations. Please inform yourself about the laws in your region and always act responsibly and in accordance with the law.

---

---

🌿 CannaGuide 2025 (Deutsch)

Der definitive KI-gestützte Cannabis-Anbau-Begleiter

CannaGuide 2025 ist Ihr digitaler Co-Pilot für den gesamten Lebenszyklus des Cannabisanbaus. Entwickelt für sowohl neugierige Einsteiger als auch für erfahrene Meisterzüchter, führt Sie diese hochmoderne Progressive Web App (PWA) von der Samenauswahl bis zur perfekt ausgehärteten Ernte. Simulieren Sie Anbauvorgänge mit einer fortschrittlichen VPD-basierten Engine, erkunden Sie eine Bibliothek mit über 500 Sorten mit einem leistungsstarken Genealogie-Tracker, diagnostizieren Sie Pflanzenprobleme per Foto, züchten Sie neue Genetiken im Labor, planen Sie Ihre Ausrüstung mit Gemini-gestützter Intelligenz und meistern Sie Ihr Handwerk mit einem interaktiven, datengesteuerten Leitfaden.

---

Inhaltsverzeichnis

• ⭐ Projektphilosophie
• 🚀 Hauptfunktionen
• 💻 Technischer Deep Dive
• 🏁 Erste Schritte (Benutzerhandbuch)
• 🛠️ Installation & Lokale Entwicklung (Entwicklerhandbuch)
• 🤔 Fehlerbehebung (Troubleshooting)
• 🔒 Sicherheit
• 🤖 Entwicklung mit AI Studio & Open Source
• 🤝 Mitwirken (Contributing)
• ⚠️ Haftungsausschluss

---

⭐ Projektphilosophie

CannaGuide 2025 basiert auf einer Reihe von Kernprinzipien, die darauf ausgelegt sind, ein erstklassiges Erlebnis zu bieten:

Offline First: Ihr Garten macht keine Pause, wenn Ihre Internetverbindung ausfällt. Die App ist so konzipiert, dass sie 100% offline funktionsfähig ist, sodass Sie immer Zugriff auf Ihre Daten und Werkzeuge haben.

Leistung ist entscheidend: Eine flüssige, reaktionsschnelle Benutzeroberfläche ist unerlässlich. Rechenintensive Aufgaben, wie die komplexe Pflanzensimulation, werden in einen Web Worker ausgelagert, um die Hauptoberfläche geschmeidig und reaktionsschnell zu halten.

Datensouveränität: Ihre Daten gehören Ihnen. Die Möglichkeit, Ihren gesamten Anwendungszustand zu exportieren und zu importieren, gibt Ihnen vollständige Kontrolle, Eigentum und Sicherheit.

KI als Co-Pilot: Wir nutzen KI nicht als Gimmick, sondern als leistungsstarkes Werkzeug, um umsetzbare, kontextbezogene Einblicke zu liefern, die den Züchter in jeder Phase wirklich unterstützen.

---

🚀 Hauptfunktionen

1. Der Grow Room (Pflanzen-Ansicht)

Ihre Kommandozentrale zur Verwaltung und Simulation von bis zu drei gleichzeitigen Anbauprojekten.

• Hochentwickelte Simulations-Engine: Erleben Sie eine Simulation, die auf VPD (Dampfdruckdefizit), biomasse-skaliertem Ressourcenverbrauch und einem strukturellen Wachstumsmodell basiert.
• Umschaltbare UI-Modi: Wechseln Sie zwischen einem einfachen Anfängermodus für die Kernaktionen und einem Expertenmodus im Header, um detaillierte wissenschaftliche Daten wie VPD und DLI anzuzeigen.
• KI-gestützte Diagnose:
  • Foto-Diagnose: Laden Sie ein Foto Ihrer Pflanze hoch, um eine sofortige KI-basierte Diagnose zu erhalten, komplett mit Sofortmaßnahmen, langfristigen Lösungen und präventiven Ratschlägen.
  • Proaktiver Berater: Erhalten Sie datengesteuerte Ratschläge von Gemini AI basierend auf den Echtzeit-Vitalwerten Ihrer Pflanze. Alle Empfehlungen können mit voller CRUD-Funktionalität archiviert werden.
• Umfassendes Protokoll: Verfolgen Sie jede Aktion – von der Bewässerung über die Düngung bis hin zum Training und zur Schädlingsbekämpfung – in einem detaillierten, filterbaren Journal für jede Pflanze.
• Nach-Ernte-Simulation: Managen Sie die kritischen Phasen des Trocknens & Fermentierens (Curing) mit einer dedizierten Oberfläche, die Feuchtigkeit, Lüftungspläne und chemische Veränderungen verfolgt, um das perfekte Endprodukt zu erzielen.

2. Die Sorten-Enzyklopädie (Sorten-Ansicht)

Ihr zentraler Wissens-Hub, konzipiert für tiefgehende Erkundungen mit Offline-First-Zugriff.

• Riesige Bibliothek: Greifen Sie auf detaillierte Informationen zu über 500 Cannabissorten zu.
• Interaktiver Stammbaum: Visualisieren Sie die vollständige genetische Abstammung jeder Sorte. Nutzen Sie Analysewerkzeuge, um Landrassen hervorzuheben, Sativa/Indica-Linien zu verfolgen, den genetischen Einfluss der Top-Vorfahren zu berechnen und bekannte Nachkommen zu entdecken.
• Hochleistungs-Suche & -Filter: Finden Sie sofort Sorten mit einer IndexedDB-gestützten Volltextsuche, alphabetischer Filterung und einem erweiterten Mehrfachauswahl-Filtermenü für THC/CBD-Bereich, Blütezeit, Aroma und mehr.
• Persönliche Sortensammlung: Genießen Sie volle CRUD (Erstellen, Lesen, Aktualisieren, Löschen)-Funktionalität, um Ihre eigenen benutzerdefinierten Sorten hinzuzufügen und zu verwalten.
• KI-Anbau-Tipps: Generieren Sie einzigartige, KI-gestützte Anbauratschläge für jede Sorte basierend auf Ihrem Erfahrungslevel und Ihren Zielen, komplett mit einem generierten Bild, und verwalten Sie diese in einem dedizierten "Tipps"-Archiv.
• Flexible Datenexport: Exportieren Sie Ihre ausgewählten oder gefilterten Sortenlisten in mehreren Formaten, einschließlich PDF, CSV, JSON, TXT und XML.

3. Die Werkstatt (Ausrüstung-Ansicht)

Ihr Werkzeugkasten für die Planung und Optimierung Ihres Anbau-Setups.

• KI-Setup-Konfigurator: Ein schlanker 2-Schritte-Prozess, bei dem Sie Ihre Pflanzenanzahl und Ihren Budget-Stil (Preis/Leistung, Ausgewogen oder Premium) auswählen, um eine vollständige, markenspezifische Ausrüstungsliste von der Gemini-KI zu erhalten.
• Gespeicherte Setups: Volle CRUD-Funktionalität für Ihre generierten Ausrüstungslisten. Bearbeiten, löschen und verwalten Sie Ihre Setups für die zukünftige Verwendung.
• Suite von Rechnern: Greifen Sie auf eine umfassende Sammlung von Präzisionswerkzeugen zu:
  • Lüftungsrechner (m³/h)
  • Beleuchtungsrechner (PPFD/DLI & Wattzahl)
  • Stromkostenrechner
  • Nährstoff-Mischrechner
  • EC/PPM-Umrechner
  • Ertragsschätzer
• Kuratierte Shop-Listen: Durchsuchen Sie empfohlene Grow Shops und Saatgutbanken für den europäischen und den US/kanadischen Markt.

4. Die Bibliothek (Wissen- & Hilfe-Ansichten)

Ihre vollständige Ressource zum Lernen und zur Problemlösung.

• Kontextsensitiver KI-Mentor: Stellen Sie dem KI-Mentor Anbaufragen, der die Daten Ihrer aktiven Pflanze für maßgeschneiderte Ratschläge nutzt. Alle Gespräche werden mit voller CRUD-Unterstützung archiviert.
• Zuchtlabor: Kreuzen Sie Ihre hochwertigsten Samen, um völlig neue, permanente Hybridsorten zu erschaffen, die Ihrer persönlichen Bibliothek hinzugefügt und in zukünftigen Anbauprojekten verwendet werden können.
• Interaktive Sandbox: Führen Sie risikofreie "Was-wäre-wenn"-Szenarien durch, wie z. B. den Vergleich von Topping vs. LST an einem Klon Ihrer Pflanze, um die Auswirkungen verschiedener Trainingstechniken über eine beschleunigte Simulation zu visualisieren.
• Umfassende Anleitungen: Greifen Sie auf ein integriertes Grower-Lexikon, visuelle Anleitungen für gängige Techniken, einen umfangreichen durchsuchbaren FAQ-Bereich und ein neues, detailliertes Benutzerhandbuch zu, das jede Funktion der App erklärt.

5. Plattformweite Funktionen

• Volle PWA- & Offline-Fähigkeit: Installieren Sie die App auf Ihrem Gerät für ein natives Erlebnis. Der robuste Service Worker gewährleistet 100% Offline-Funktionalität, einschließlich Zugriff auf alle Daten und KI-Archive.
• Befehlspalette (Cmd/Ctrl + K): Ein Power-User-Tool für sofortige, klickfreie Navigation und Aktionen in der gesamten Anwendung.
• Vollständige Datensouveränität: Exportieren Sie alle Ihre App-Daten (Pflanzen, Einstellungen, Archive, eigene Sorten) in eine einzige JSON-Datei zur Sicherung. Importieren Sie sie später, um Ihren Zustand auf jedem Gerät vollständig wiederherzustellen.
• Erweiterte Barrierefreiheit: Bietet eine Legastheniker-freundliche Schriftart, einen Modus mit reduzierter Bewegung und eine integrierte Text-zu-Sprache (TTS)-Funktionalität für wichtige Inhalte.

---

💻 Technischer Deep Dive

CannaGuide 2025 basiert auf einem modernen, robusten und skalierbaren Tech-Stack, der auf Leistung und Offline-First-Zuverlässigkeit ausgelegt ist.

• Frontend-Framework: React 19 mit TypeScript für eine moderne, typsichere und performante Benutzeroberfläche.
• Zustandsverwaltung: Redux Toolkit (^2.2) dient als zentrale Datenquelle ("Single Source of Truth"), was vorhersagbare Zustandsübergänge gewährleistet und das Debugging vereinfacht.
• Asynchrone Operationen & KI:
  • RTK Query verwaltet alle Interaktionen mit der Google Gemini API (@google/genai ^1.19) und bietet Caching sowie ein optimiertes Lade-/Fehlerzustandsmanagement. Das gemini-2.5-flash-Modell wird für seine optimale Balance aus Geschwindigkeit, Kosten und der Fähigkeit zur strukturierten JSON-Ausgabe verwendet.
  • Die Pflanzenwachstumssimulation läuft in einem dedizierten Web Worker, wodurch der Haupt-UI-Thread reaktionsschnell und flüssig bleibt.
• Datenpersistenz: Eine robuste IndexedDB-Strategie gewährleistet vollständige Offline-Verfügbarkeit.
  • Der Kern-Redux-Zustand wird über eine Listener-Middleware persistiert, was eine nahtlose Zustandshydratisierung und -migration beim App-Start ermöglicht.
  • Große statische Daten wie die Sortenbibliothek und der Suchindex werden zur Leistungsoptimierung in einer separaten IndexedDB verwaltet.
• PWA & Offline-Fähigkeit: Ein Service Worker implementiert eine "Cache First, then Network"-Strategie, wodurch die Anwendung vollständig installierbar und ohne Internetverbindung funktionsfähig ist.
• Styling: Tailwind CSS (über CDN) ermöglicht einen schnellen, Utility-First-Ansatz zum Erstellen eines konsistenten und responsiven Designsystems, das direkt in index.html konfiguriert wird.

---

🏁 Erste Schritte (Benutzerhandbuch)

Außer einem modernen Webbrowser ist keine Installation erforderlich.

1. Onboarding: Beim ersten Start werden Sie durch ein kurzes Tutorial geführt, um Ihre bevorzugte Sprache einzustellen.
2. Sorten entdecken: Beginnen Sie in der Sorten-Ansicht. Nutzen Sie die Suche und die Filter, um eine Sorte zu finden, und speichern Sie sie als Favorit, indem Sie auf das Herzsymbol klicken.
3. Anbau starten: Navigieren Sie zum Pflanzen-Dashboard. Klicken Sie auf einen leeren Steckplatz, wählen Sie "Neuen Anbau starten", wählen Sie eine Sorte aus Ihren Favoriten oder der Hauptliste aus und konfigurieren Sie Ihr Setup.
4. Ihren Anbau verwalten: Das Pflanzen-Dashboard ist Ihre Kommandozentrale. Protokollieren Sie Aktionen wie Gießen und Düngen, überprüfen Sie die Vitalwerte Ihrer Pflanze und holen Sie sich Ratschläge von der KI.
5. Befehlspalette verwenden: Drücken Sie für den schnellsten Zugriff Cmd/Ctrl + K, um sofort zu navigieren oder Aktionen auszuführen.

---

🛠️ Installation & Lokale Entwicklung (Entwicklerhandbuch)

Um CannaGuide 2025 lokal für die Entwicklung auszuführen, befolgen Sie diese Schritte.

Voraussetzungen

• Node.js (v18.x oder neuer empfohlen)
• npm (normalerweise bei Node.js enthalten)
• Ein Google Gemini API Key. Diesen erhalten Sie im Google AI Studio.

Installation

1. Repository klonen:

   git clone https://github.com/qnbs/CannaGuide-2025.git
   cd CannaGuide-2025

2. Abhängigkeiten installieren:

   npm install

3. Umgebungsvariablen einrichten: Die Anwendung benötigt einen Google Gemini API-Schlüssel. Erstellen Sie eine .env-Datei im Stammverzeichnis des Projekts:

   touch .env

   Öffnen Sie die .env-Datei und fügen Sie Ihren API-Schlüssel hinzu:

   API_KEY=YOUR_GEMINI_API_KEY
   

   Hinweis: Dieses Setup geht von einer Entwicklungsumgebung aus, die Umgebungsvariablen bereitstellt (wie Vite oder Create React App). Der Anwendungscode greift direkt auf process.env.API_KEY zu.

4. Anwendung ausführen: Dieses Projekt ist für die Ausführung im Google AI Studio konzipiert, das den Entwicklungsserver bereitstellt. Bei lokaler Ausführung würden Sie typischerweise einen Befehl wie diesen verwenden:

   npm start 

   (Hinweis: Die package.json enthält dieses Skript nicht; Sie müssten es hinzufügen oder einen lokalen Server verwenden.)

Build-Prozess

Um einen produktionsfertigen Build zu erstellen, würden Sie typischerweise Folgendes ausführen:

npm run build

Dieser Befehl würde den Code bündeln und optimieren und ihn für die Bereitstellung vorbereiten. (Hinweis: Die package.json enthält dieses Skript nicht.)

---

🤔 Fehlerbehebung (Troubleshooting)

• KI-Funktionen funktionieren nicht: Dies liegt fast immer an einem fehlenden oder ungültigen Gemini API-Schlüssel. Stellen Sie sicher, dass Ihre .env-Datei korrekt eingerichtet ist und der Schlüssel gültig ist. Überprüfen Sie die Entwicklerkonsole Ihres Browsers auf 4xx-Fehler im Zusammenhang mit der Google-API.
• App aktualisiert sich nicht (PWA-Caching): Wenn Sie Änderungen vorgenommen haben, diese aber nicht sehen, könnte der Service Worker eine zwischengespeicherte Version ausliefern.
  1. Öffnen Sie die Entwicklertools Ihres Browsers.
  2. Gehen Sie zum Tab Anwendung (Application).
  3. Suchen Sie Service Workers, aktivieren Sie "Update on reload" (Bei Neuladen aktualisieren) und klicken Sie auf "Unregister" (Registrierung aufheben) für den CannaGuide-Service-Worker.
  4. Gehen Sie zu Speicher (Storage) und klicken Sie auf "Site data löschen" (Clear site data).
  5. Aktualisieren Sie die Seite.
• Datenprobleme: Sollte der Zustand der Anwendung beschädigt werden, können Sie einen Hard-Reset durchführen, indem Sie zu Einstellungen > Datenverwaltung > Alle App-Daten zurücksetzen navigieren. Achtung: Dies löscht alle Ihre lokalen Daten.

---

🔒 Sicherheit

• API-Schlüssel-Verwaltung: Ihr Gemini API-Schlüssel ist ein Geheimnis. Übergeben Sie Ihre .env-Datei nicht an die Versionskontrolle und legen Sie den Schlüssel nicht in clientseitigem Code offen, der öffentlich zugänglich ist. Die .gitignore-Datei sollte .env enthalten.
• Abhängigkeiten: Überprüfen Sie regelmäßig die Abhängigkeiten des Projekts auf Schwachstellen, indem Sie Folgendes ausführen:

  npm audit

  Halten Sie Pakete auf ihren neuesten stabilen Versionen, um Sicherheitsrisiken zu minimieren.

---

🤖 Entwicklung mit AI Studio & Open Source

Diese Anwendung wurde vollständig mit Googles AI Studio entwickelt. Der gesamte Prozess, vom anfänglichen Projekt-Setup bis zur Implementierung komplexer Funktionen wie der Redux-Zustandsverwaltung und der Web-Worker-Simulation, wurde durch iterative Anweisungen in natürlicher Sprache gesteuert.

Dieses Projekt ist zudem vollständig Open Source. Tauchen Sie in den Code ein, forken Sie das Projekt oder tragen Sie auf GitHub bei. Erleben Sie aus erster Hand, wie natürliche Sprache anspruchsvolle Anwendungen erstellen kann.

• Projekt in AI Studio forken: https://ai.studio/apps/drive/1_F6ArMCdXQt-1fWzTf0R6Sgge9lXxz4-
• Quellcode auf GitHub ansehen: https://github.com/qnbs/CannaGuide-2025

---

🤝 Mitwirken (Contributing)

Wir freuen uns über Beiträge aus der Community! Ob Sie einen Fehler beheben, eine neue Funktion hinzufügen oder Übersetzungen verbessern möchten, Ihre Hilfe ist willkommen.

1. Probleme melden: Wenn Sie einen Fehler finden oder eine Idee haben, eröffnen Sie bitte zuerst ein Issue auf GitHub, um es zu besprechen.
2. Änderungen vornehmen:
   • Forken Sie das Repository.
   • Erstellen Sie einen neuen Branch für Ihr Feature oder Ihren Bugfix (git checkout -b feature/mein-neues-feature).
   • Committen Sie Ihre Änderungen (git commit -am 'Füge ein Feature hinzu').
   • Pushen Sie den Branch (git push origin feature/mein-neues-feature).
   • Erstellen Sie einen neuen Pull Request.

Bitte halten Sie sich an den bestehenden Codestil und stellen Sie sicher, dass Ihre Änderungen gut dokumentiert sind.

---

⚠️ Haftungsausschluss

Alle Informationen in dieser App dienen ausschließlich zu Bildungs- und Unterhaltungszwecken. Der Anbau von Cannabis unterliegt strengen gesetzlichen Bestimmungen. Bitte informieren Sie sich über die Gesetze in Ihrer Region und handeln Sie stets verantwortungsbewusst und im Einklang mit dem Gesetz.