HOW TO USE CROPCARE AI - USER GUIDE Last Updated: September 25, 2025 Version: 1.0.1+15 =============================================================================== GETTING STARTED WITH CROPCARE AI =============================================================================== CropCare AI is a comprehensive agricultural technology platform that combines AI-powered plant disease detection, subscription-based premium features, and multi-platform access through mobile app and web platform. This guide will help you use all features effectively and safely. =============================================================================== 1. INSTALLATION AND SETUP =============================================================================== 1.1 SYSTEM REQUIREMENTS - iOS 13.0+ or Android 5.0+ (API level 21+) - Camera access permission for plant scanning - Internet connection required for AI analysis (online service) - Minimum 200MB free storage space for app and analysis history - Universal Link support: https://cropcare.hamez.dev/ deep linking - Google Play Services for subscription management (Android) - App Store connectivity for subscription management (iOS) 1.2 FIRST-TIME SETUP 1. Download and install CropCare AI from Google Play Store or Apple App Store 2. Create your account using email or OAuth2 authentication 3. Grant required permissions (camera, storage) when prompted 4. Choose your region for appropriate pricing (developed/underdeveloped regions) 5. Select subscription plan: Free (5 scans/month) or Premium (unlimited) 6. Complete profile setup with your location for better recommendations 1.3 PERMISSIONS EXPLAINED - Camera: Required to capture photos of plants for AI analysis - Storage: Needed to save analysis history and images locally using Hive database - Internet: Essential for AI analysis via GitHub Models API and backend validation - Location (optional): For regional pricing and environmental context in analysis - Notifications: For subscription updates and scan limit notifications 1.4 SUBSCRIPTION SYSTEM CropCare uses a freemium model with regional pricing: FREE TIER: - 5 AI scans per month - Basic plant disease detection - Treatment recommendations - Limited history storage PREMIUM SUBSCRIPTION (Regional Pricing): - Unlimited AI scans - Advanced analysis with confidence scores - Complete treatment plans (natural & chemical options) - Full analysis history with export capabilities - Priority customer support - Access to web platform dashboard - Organizational features (team collaboration) REGIONAL PRICING: - Developed regions: $30.00/month, $300.00/year - Underdeveloped regions: $5.00/month, $50.00/year - Pricing automatically adjusted based on user region =============================================================================== 2. TAKING PLANT PHOTOS FOR BEST RESULTS =============================================================================== 2.1 PHOTO QUALITY GUIDELINES ✓ Use good lighting (natural daylight preferred) ✓ Keep plant in focus with clear details visible ✓ Include affected areas (leaves, stems, flowers) ✓ Capture multiple angles if disease is present ✓ Use rear camera for better image quality 2.2 WHAT TO AVOID ✗ Blurry or out-of-focus images ✗ Poor lighting (too dark or overexposed) ✗ Too much background clutter ✗ Extreme close-ups that miss plant context ✗ Images with fingers or objects blocking the plant 2.3 OPTIMAL PHOTO CONDITIONS - Distance: 12-24 inches from plant - Lighting: Even, natural light (avoid direct flash) - Background: Clean, contrasting background preferred - Angle: Include leaves, stems, and affected areas - Time: Morning or afternoon for best natural lighting =============================================================================== 3. ANALYZING PLANTS =============================================================================== 3.1 STARTING AN ANALYSIS 1. Open CropCare AI app and ensure internet connectivity 2. Check your scan limit (shown on dashboard): Free users have 5/month 3. Tap "Take Photo" for camera or "Choose from Gallery" for existing images 4. Review the selected image and ensure good quality 5. After confirming selection, it will automatically start AI processing 6. Wait for analysis results (typically 15-45 seconds depending on connection) 7. Results are automatically saved to local history for future reference 3.2 UNDERSTANDING RESULTS The AI analysis provides comprehensive information: - Plant Identification: Common and scientific names with confidence scores - Disease Detection: Health status, specific disease identification, or "healthy" status - Confidence Score: AI model's confidence level (0-100%) for reliability assessment - Severity Assessment: Disease progression level (mild, moderate, severe) - Detailed Symptoms: Visible signs and symptoms observed in the image - Treatment Plans: Categorized recommendations: * Natural treatments (organic, eco-friendly solutions) * Chemical treatments (faster-acting synthetic options) * Cultural practices (environmental management) - Prevention Tips: Proactive measures to prevent future problems - Estimated Recovery: Timeline for treatment effectiveness 3.3 CONFIDENCE SCORES GUIDE - 90-100%: Very High confidence (reliable identification) - 70-89%: High confidence (good identification) - 50-69%: Moderate confidence (verify with expert) - Below 50%: Low confidence (seek professional advice) =============================================================================== 4. SUBSCRIPTION MANAGEMENT =============================================================================== 4.1 ACCESSING SUBSCRIPTION SETTINGS - Open app settings or profile section - Tap "Subscription" or "Premium" to view current plan - View remaining scans for free users - Manage subscription through Google Play Store or Apple App Store - Access billing history and usage statistics 4.2 UPGRADING TO PREMIUM 1. Tap "Upgrade to Premium" from settings 2. Choose between Monthly or Yearly plans (save 17% with yearly) 3. Regional pricing automatically applied based on your location 4. Complete purchase through your device's app store 5. Premium features activate immediately after successful payment 6. Subscription auto-renews unless cancelled 4.3 SUBSCRIPTION VALIDATION - All subscriptions validated with backend server - Purchases verified with Google Play Store or Apple App Store - Account linking prevents unauthorized subscription sharing - Real-time subscription status updates - Grace period provided for expired subscriptions with temporary issues 4.4 MANAGING BILLING - Cancel anytime through Google Play Store or Apple App Store settings - Refunds handled according to store policies - Subscription remains active until end of current billing period - Downgrade to free tier with 5 scans/month after cancellation =============================================================================== 5. PLATFORM ACCESS =============================================================================== 5.1 MOBILE APP (Primary Platform) - AI-powered scanning and analysis - Offline result viewing (analysis requires internet) - Local storage using Hive database and Flutter Secure Storage - Push notifications for subscription and scan limit updates 5.2 WEB PLATFORM ACCESS - URL: https://cropcare.hamez.dev - Advanced dashboard and analytics - Team collaboration features for organizations - Bulk analysis management - API access for enterprise customers - Comprehensive reporting and export tools 5.3 DEEP LINKING AND UNIVERSAL LINKS - Universal Link: https://cropcare.hamez.dev/app/ - Custom scheme: cropcare:// - Seamless transitions between web and mobile platforms - Shared analysis links for team collaboration - Password reset and account verification via links =============================================================================== 6. INTERPRETING TREATMENT RECOMMENDATIONS =============================================================================== 6.1 NATURAL TREATMENTS 🌿 - Organic and eco-friendly solutions - Safer for environment and beneficial insects - May take longer to show results (7-14 days typically) - Examples: neem oil, baking soda solutions, beneficial bacteria, companion planting - Cost-effective and sustainable long-term solutions 6.2 CHEMICAL TREATMENTS 🧪 - Faster-acting synthetic solutions (2-7 days typical response) - More potent but may have environmental impact - Higher cost but immediate effectiveness - Examples: fungicides, bactericides, systemic treatments, targeted pesticides - Professional-grade recommendations with application rates 6.3 CULTURAL PRACTICES 🌱 - Environmental management and prevention-focused approaches - Irrigation management, soil amendments, crop rotation suggestions - Long-term plant health improvement strategies - Sustainable farming practice integration 6.4 TREATMENT SAFETY ⚠️ IMPORTANT SAFETY REMINDERS: - Always read and follow product labels and local regulations - Wear appropriate protective equipment when applying treatments - Consider environmental impact and effects on beneficial insects - Test treatments on small areas first to assess plant tolerance - Consult local agricultural extension services for region-specific advice - Never apply treatments in windy conditions or before rain - Respect pre-harvest intervals for food crops - Store chemicals safely away from children and pets =============================================================================== 7. MANAGING ANALYSIS HISTORY =============================================================================== 7.1 VIEWING HISTORY - Tap "History" tab to see all past analyses stored locally - Scroll through chronological list organized by date (newest first) - Tap any item to view detailed analysis results and images - Search functionality for finding specific plants or diseases - Filter by date range, confidence level, or disease status 7.2 DATA STORAGE AND SYNC - All analysis data stored locally using Hive database - Images and results cached for offline viewing - Premium users get cloud backup and cross-device sync - Export functionality for data portability - Analysis data includes metadata: timestamp, confidence scores, treatment effectiveness tracking 7.3 ORGANIZING AND MANAGING DATA - Create custom tags and categories for your analyses - Mark treatments as applied and track effectiveness - Set reminders for follow-up scans and treatment applications - Share individual analyses with team members or experts - Bulk export for record-keeping and reporting 7.4 DELETING DATA - Swipe left on individual items to delete from local storage - Use "Clear All History" to remove all stored data (requires confirmation) - Deleted data cannot be recovered unless backed up to cloud (Premium feature) - Consider exporting important analyses before deletion - Free up storage space by removing old, resolved analyses =============================================================================== 8. BEST PRACTICES FOR ACCURATE RESULTS =============================================================================== 8.1 PHOTO PREPARATION - Clean plant leaves gently with soft cloth before photographing - Remove dead or severely damaged material for clearer analysis - Ensure plant is well-watered (not wilted from drought stress) - Check multiple areas of the plant for comprehensive assessment - Take photos during optimal lighting hours (10 AM - 3 PM) 8.2 OPTIMAL PHOTO TECHNIQUES - Distance: 15-30 cm from affected plant parts - Lighting: Even, natural daylight (avoid direct flash or artificial lighting) - Background: Clean, contrasting background (use white paper if needed) - Focus: Ensure affected areas are sharp and clearly visible - Angle: Capture both overall plant structure and close-up disease details - Multiple shots: Take 2-3 angles for complex disease patterns 8.3 ENVIRONMENTAL CONTEXT - Note recent weather conditions (rainfall, temperature, humidity) - Document watering schedule and soil moisture conditions - Record recent fertilizer applications or treatment history - Consider seasonal timing and plant growth stage - Include information about nearby plants and potential disease spread 8.4 MAXIMIZING AI ACCURACY - Upload high-resolution images (minimum 1MP recommended) - Ensure good internet connectivity for faster processing - Provide plant type information when prompted - Use macro mode for detailed leaf symptoms - Avoid heavily filtered or edited images - Take photos in RAW or highest quality settings available =============================================================================== 9. WHEN TO SEEK PROFESSIONAL HELP =============================================================================== 9.1 CRITICAL SITUATIONS REQUIRING EXPERT CONSULTATION - Valuable or rare plants showing severe or unknown symptoms - Commercial crops or food production with significant disease spread - Rapid disease progression affecting multiple plants or crops - Uncertainty about treatment safety, application rates, or timing - Low confidence scores (<70%) from AI analysis - Suspected new or emerging diseases not in AI training data - Economic losses exceeding treatment costs 9.2 PROFESSIONAL RESOURCES - Local agricultural extension services and county agents - Certified plant pathologists and diagnosticians - Professional horticulturists and crop consultants - University plant diagnostic laboratories - Agricultural cooperatives and farm advisors - Crop insurance adjusters for commercial operations - Integrated pest management (IPM) specialists 9.3 AI LIMITATIONS TO UNDERSTAND - GitHub Models AI service provides preliminary assessments, not definitive diagnoses - Cannot replace professional plant pathology expertise or laboratory testing - Limited by image quality, lighting conditions, and camera capabilities - May not consider complex interactions between multiple stressors - Training data may not include all regional diseases or emerging pathogens - Cannot assess soil conditions, water quality, or environmental factors 9.4 GEOGRAPHIC AND REGIONAL CONSIDERATIONS - AI training data may have geographic bias toward certain regions - Disease prevalence and treatment options vary by climate and location - Local regulations may restrict certain pesticides or treatment methods - Regional pest and disease pressure may differ from AI training data - Always verify recommendations with local agricultural authorities - Consider traditional knowledge and local farming practices - Adapt treatments based on local environmental conditions =============================================================================== 10. TROUBLESHOOTING COMMON ISSUES =============================================================================== 10.1 ANALYSIS ERRORS AND CONNECTIVITY Problem: "Failed to analyze image" or "Network connection error" Solutions: - Verify stable internet connection (WiFi or cellular data) - Check if you've reached scan limits (Free: 5/month, Premium: unlimited) - Ensure image is clear, well-lit, and under 10MB in size - Try taking a new photo with better lighting and focus - Restart the app and attempt analysis again - Verify subscription status if premium features expected - Clear app cache if performance issues persist 10.2 SUBSCRIPTION AND BILLING ISSUES Problem: "Subscription not recognized" or billing problems Solutions: - Verify purchase completed through Google Play Store or Apple App Store - Check subscription status in app store account settings - Ensure account email matches subscription purchase - Wait 5-10 minutes for subscription validation with backend - Try "Restore Purchases" option in app settings - Contact app store support for refund or billing disputes - Ensure app is updated to latest version for subscription fixes 10.3 POOR ANALYSIS RESULTS Problem: Low confidence scores, unclear identification, or irrelevant results Solutions: - Retake photo with better lighting, focus, and image composition - Include more plant context (affected leaves, stems, overall plant) - Ensure image shows clear disease symptoms, not just healthy parts - Try analyzing different affected areas of the same plant - Consider that some plant conditions may be difficult to diagnose automatically - Consult professional help for complex or unusual symptoms - Verify plant type selection if prompted by AI system 10.4 APP PERFORMANCE AND STORAGE Problem: Slow analysis, app crashes, or storage full notifications Solutions: - Close other resource-intensive apps to free device memory - Restart device to clear temporary files and refresh memory - Update to latest app version through app store - Clear analysis history to free local storage space - Check available device storage (app requires minimum 200MB) - Disable unnecessary background apps during analysis - Consider upgrading device if hardware limitations persist =============================================================================== 11. PRIVACY AND DATA SECURITY =============================================================================== 11.1 YOUR DATA AND STORAGE - Analysis history stored locally on device using encrypted Hive database - Images stored securely in app-specific directories with restricted access - Authentication tokens protected via Flutter Secure Storage with hardware-backed keystore - Personal information encrypted both at rest and in transit - You maintain full control over data deletion and export - No unauthorized access to your analysis data or images 11.2 DATA TRANSMISSION AND PROCESSING - Images transmitted securely to GitHub Models API via HTTPS encryption - Backend validation with OAuth2 authentication - Temporary processing only - no permanent storage of images on external servers - Analysis results and metadata stored locally on your device - Subscription validation handled through secure app store APIs - Regional data processing compliance with local privacy regulations 11.3 SUBSCRIPTION AND PAYMENT DATA - Payment processing handled exclusively by Google Play Store or Apple App Store - CropCare never stores credit card or payment information directly - Subscription status validated through secure store APIs - Purchase receipts encrypted and stored temporarily for validation - Billing information managed through your app store account - Refunds and billing disputes handled by respective app stores 11.4 SHARING AND COLLABORATION - Premium users can share analysis results with team members - Shared data encrypted and access-controlled through user permissions - Enterprise accounts have additional security and compliance features - Organization administrators can manage user access and data retention - All sharing activities logged and auditable for security purposes - Users can revoke shared access at any time through account settings =============================================================================== 12. ADVANCED FEATURES (PREMIUM) =============================================================================== 12.1 TEAM COLLABORATION AND ORGANIZATIONS - Create or join agricultural organizations for team-based analysis - Share analysis results and treatment plans with colleagues - Collaborative decision-making tools for farm management - Role-based access control (admin, analyst, viewer permissions) - Centralized billing and subscription management for organizations - Team analytics and reporting dashboards 12.2 ADVANCED ANALYTICS AND REPORTING - Historical trend analysis for crop health patterns - Seasonal disease occurrence tracking and predictions - Treatment effectiveness monitoring and optimization - Export detailed reports in multiple formats (PDF, CSV, JSON) - Integration with farm management software via API - Custom alerts and notifications for disease outbreaks 12.3 API ACCESS AND ENTERPRISE FEATURES - RESTful API for third-party application integration - Bulk image processing capabilities for large-scale operations - Custom AI model training for specific crop varieties or regions - Dedicated technical support and account management - Service level agreements (SLA) for enterprise customers - White-label solutions for agricultural service providers 12.4 CLOUD SYNCHRONIZATION AND BACKUP - Automatic backup of analysis history to secure cloud storage - Cross-device synchronization for seamless multi-platform use - Data recovery options in case of device loss or damage - Version control for analysis results and treatment tracking - Compliance with industry data retention standards - Geographic data residency options for regulatory compliance =============================================================================== 13. COMPLIANCE AND REGULATORY INFORMATION =============================================================================== 13.1 AGRICULTURAL REGULATIONS COMPLIANCE - Treatment recommendations comply with major agricultural regulatory frameworks - Pesticide and chemical suggestions include regulatory approval status - Organic farming compliance indicators for treatment options - Regional adaptation of recommendations based on local regulations - Integration with agricultural extension service databases - Regular updates to reflect changing regulatory landscapes 13.2 DATA PROTECTION AND PRIVACY COMPLIANCE - GDPR compliance for European Union users - CCPA compliance for California residents - PIPEDA compliance for Canadian users - Industry-standard data encryption and security measures - Regular third-party security audits and penetration testing - Transparent privacy policy and data handling practices 13.3 QUALITY ASSURANCE AND ACCURACY STANDARDS - Continuous AI model validation and improvement processes - Collaboration with agricultural research institutions for accuracy verification - Regular updates based on latest plant pathology research - User feedback integration for model refinement - Statistical accuracy reporting and transparency - Independent validation of AI recommendations by agricultural experts =============================================================================== 14. GETTING HELP AND SUPPORT =============================================================================== 14.1 CUSTOMER SUPPORT CHANNELS - In-app help center with searchable knowledge base - Email support: support@cropcare.hamez.dev (response within 24-48 hours) - Priority support for premium subscribers (same-day response) - Community forums for peer support and knowledge sharing - Video tutorials and step-by-step guides - Live chat support (premium subscribers only) 14.2 EMERGENCY AGRICULTURAL SUPPORT - Critical crop disease emergency hotline (premium feature) - Direct connection to agricultural extension services - Emergency consultation with plant pathology experts - Rapid response team for commercial crop emergencies - 24/7 technical support for enterprise customers - Integration with local agricultural emergency services 14.3 TRAINING AND EDUCATIONAL RESOURCES - Comprehensive video tutorial library - Webinars on plant disease identification and management - Best practices guides for different crop types - Seasonal farming calendars and disease prevention schedules - Integration with agricultural education institutions - Certification programs for agricultural professionals =============================================================================== 15. FUTURE DEVELOPMENTS AND ROADMAP =============================================================================== 15.1 PLANNED FEATURES AND IMPROVEMENTS - Enhanced AI models for improved accuracy and new crop types - Satellite imagery integration for field-scale crop monitoring - Weather data integration for predictive disease modeling - Soil analysis integration for comprehensive plant health assessment - Drone integration for large-scale crop monitoring - Augmented reality (AR) features for in-field plant identification 15.2 RESEARCH AND DEVELOPMENT INITIATIVES - Partnerships with leading agricultural research institutions - Open-source contributions to agricultural technology community - Participation in global food security and sustainability initiatives - Development of region-specific AI models for emerging markets - Integration with precision agriculture and IoT technologies - Climate change adaptation features for evolving agricultural challenges 15.3 USER FEEDBACK AND FEATURE REQUESTS - Regular user surveys and feedback collection - Feature request voting system for premium users - Beta testing programs for new features - User advisory board for strategic product direction - Regular product updates based on user needs and feedback - Transparency in development priorities and release schedules =============================================================================== CONCLUSION =============================================================================== CropCare AI is designed to be your intelligent farming companion, providing accurate plant disease detection and treatment recommendations while respecting your privacy and supporting sustainable agricultural practices. Remember that AI analysis should complement, not replace, professional agricultural expertise. Always consult with local agricultural extension services, plant pathologists, or certified crop advisors for critical decisions affecting valuable crops, commercial operations, or food safety. For the most up-to-date information, feature announcements, and agricultural insights, visit our website at https://cropcare.hamez.dev or follow our community forums. Thank you for choosing CropCare AI to support your agricultural success! =============================================================================== CONTACT INFORMATION =============================================================================== General Support: support@cropcare.hamez.dev Technical Issues: technical@cropcare.hamez.dev Business Inquiries: business@cropcare.hamez.dev Security Concerns: security@cropcare.hamez.dev Website: https://cropcare.hamez.dev Mobile App: Available on Google Play Store and Apple App Store Documentation: https://cropcare.hamez.dev/docs Community Forums: https://cropcare.hamez.dev/community Physical Address: CropCare AI Kahawa, Kenya © 2025 CropCare AI. All rights reserved. Version 1.0.1+15 - Last Updated: September 25, 2025