🌱 Smart Farm IoT & Weed Detection System

A comprehensive IoT-powered smart farming solution with AI-driven weed detection and real-time monitoring capabilities.

🚀 Overview

Smart Farm IoT is a cutting-edge mobile application that revolutionizes modern agriculture by combining Internet of Things (IoT) sensors, machine learning-powered weed detection, and intuitive farm management tools. Built with Flutter for cross-platform compatibility, this app empowers farmers to monitor their crops in real-time, detect weeds automatically, and make data-driven decisions to optimize their farming operations.

✨ Key Features

🔐 Authentication & Security

• Firebase Authentication with email/password and Google Sign-In
• Secure user registration and login system
• Password reset functionality
• Session management and auto-login

📊 Real-Time IoT Monitoring

• Live sensor data from multiple farm locations
• Temperature, humidity, soil moisture, and light intensity tracking
• Interactive charts with historical data visualization
• Real-time alerts and notifications for critical conditions
• CORS-compliant API integration with fallback mock data

🤖 AI-Powered Weed Detection

• Machine learning integration for automated weed identification
• Camera-based weed detection with image upload
• Real-time analysis and classification results
• Detection history and analytics

🚜 Farm Management

• Multi-farm support with detailed farm profiles
• Comprehensive dashboard with key metrics
• Equipment control and monitoring
• Crop management and planning tools

📱 Modern Mobile Experience

• Cross-platform support (Android & iOS)
• Intuitive navigation with bottom tab bar
• Dark/Light theme support
• Responsive design for all screen sizes
• Offline capability with data synchronization

👤 User Profile & Settings

• Editable user profiles with image upload
• Farm information management
• Statistics and performance metrics
• Notification preferences
• Data export functionality

🛠️ Technology Stack

Frontend

• Flutter 3.x - Cross-platform mobile framework
• Dart - Programming language
• Google Fonts - Typography
• FL Chart - Interactive data visualization
• Image Picker - Camera and gallery integration

Backend & Services

• Firebase Authentication - User management
• Firebase Cloud Firestore - Real-time database
• REST API - IoT sensor data integration
• Google Services - OAuth and cloud integration

Architecture

• Feature-based architecture for scalability
• Provider/Bloc pattern for state management
• Repository pattern for data abstraction
• Clean architecture principles

📁 Project Structure

lib/
├── features/
│   ├── auth/
│   │   ├── screens/
│   │   │   ├── login_screen.dart
│   │   │   └── register_screen.dart
│   │   └── services/
│   ├── home/
│   │   └── screens/
│   │       ├── home_screen.dart
│   │       ├── farm_details_screen.dart
│   │       └── profile_screen.dart
│   ├── weed_detection/
│   │   └── screens/
│   │       └── weed_detection_screen.dart
│   ├── control/
│   │   └── screens/
│   │       └── control_car_screen.dart
│   ├── notifications/
│   │   └── screens/
│   │       └── notifications_screen.dart
│   └── camera/
│       └── screens/
│           └── camera_screen.dart
├── services/
│   ├── auth_service.dart
│   └── api_service.dart
├── models/
│   └── sensor_data.dart
├── firebase_options.dart
└── main.dart

🚀 Getting Started

Prerequisites

• Flutter SDK (3.0 or higher)
• Dart SDK (3.0 or higher)
• Android Studio or VS Code with Flutter extensions
• Firebase project with Authentication and Firestore enabled
• Android/iOS device or emulator

Installation

1. Clone the repository

   git clone https://github.com/yourusername/weed_detection_iot_ml.git
   cd weed_detection_iot_ml

2. Install dependencies

   flutter pub get

3. Firebase Setup

   • Create a new Firebase project at Firebase Console
   • Enable Authentication (Email/Password and Google Sign-In)
   • Enable Cloud Firestore
   • Download google-services.json (Android) and GoogleService-Info.plist (iOS)
   • Place the files in their respective platform directories

4. Configure Firebase

   flutter packages pub run build_runner build

5. Run the application

   flutter run

📱 Screenshots & Demo

🎥 App Demo Video

🔐 Authentication Flow

Clean, modern authentication with email/password and Google Sign-In integration

🏠 Dashboard & Home

Real-time dashboard with comprehensive farm monitoring and statistics

📊 Data Visualization & Analytics & Notification

Interactive charts with real-time sensor data and historical analytics

🤖 AI Weed Detection

AI-powered weed detection with camera integration and real-time analysis

🚜 Farm Management & Control

Comprehensive farm management with equipment control and monitoring

👤 Profile & Settings

User profile management with editable information and notification settings

📱 App Features Overview

Feature	Screenshot	Description
Login		Secure authentication with form validation
Dashboard		Real-time farm monitoring overview
Charts		Interactive data visualization
Weed Detection		AI-powered weed identification
Profile		User and farm information management

📂 Screenshots Folder Structure

To add your own screenshots, create a screenshots folder in your project root with these files:

screenshots/
├── app_demo.mp4                    # App demo video
├── login_screen.png               # Login screen
├── register_screen.png            # Registration screen
├── google_signin.png              # Google Sign-In flow
├── home_dashboard.png             # Main dashboard
├── sensor_overview.png            # Sensor data overview
├── farm_stats.png                 # Farm statistics
├── interactive_charts.png         # Data visualization charts
├── sensor_details.png             # Detailed sensor view
├── historical_data.png            # Historical data analysis
├── weed_detection_camera.png      # Weed detection camera
├── weed_analysis.png              # Weed analysis results
├── detection_results.png          # Detection outcome
├── farm_details.png               # Farm management details
├── control_panel.png              # Equipment control panel
├── equipment_control.png          # Equipment monitoring
├── profile_view.png               # User profile view
├── profile_edit.png               # Profile editing mode
└── notifications.png              # Notifications screen

🎯 How to Capture Screenshots

1. Run your Flutter app on a device or emulator
2. Navigate to each screen you want to capture
3. Take screenshots using:
   • Android: Power + Volume Down
   • iOS: Power + Volume Up
   • Emulator: Use built-in screenshot tools
4. Save images in the screenshots folder with the names listed above
5. Record a demo video showing the app's key features

🔧 Configuration

API Configuration

Update the API endpoints in lib/services/api_service.dart:

static const String baseUrl = 'YOUR_IOT_API_ENDPOINT';

Firebase Configuration

Ensure your firebase_options.dart is properly configured with your project credentials.

🧪 Testing

Run the test suite:

flutter test

For integration tests:

flutter drive --target=test_driver/app.dart

📦 Build & Deployment

Android

flutter build apk --release
# or for app bundle
flutter build appbundle --release

iOS

flutter build ios --release

🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Development Guidelines

• Follow Flutter/Dart style guidelines
• Write comprehensive tests for new features
• Update documentation for API changes
• Ensure cross-platform compatibility

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Flutter Team for the amazing framework
• Firebase for backend services
• Material Design for UI components
• IoT sensor manufacturers for hardware integration
• Open source community for various packages and tools

📞 Support & Contact

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: your.email@example.com

---

Made with ❤️ for sustainable agriculture

Empowering farmers with technology for a greener future