Farmers - Smart Greenhouse Management System

Empowering farmers with IoT-driven precision agriculture for optimized greenhouse management

📖 Table of Contents

Overview
Key Features
Architecture
Technical Stack
AWS Services Integration
Project Structure
IoT Device Integration
Usage
Screenshots
License

🌱 Overview

Farmers is a comprehensive IoT-enabled mobile application designed to revolutionize greenhouse management for modern agriculture. Built with Flutter and powered by AWS services, this application enables farmers to:

Monitor multiple greenhouses in real-time
Manage IoT sensor devices for environmental tracking
Control automated systems (irrigation, ventilation, lighting)
Receive AI-powered insights and recommendations
Track crop growth stages and optimize farming practices

The app connects to IoT devices through AWS IoT Core using secure MQTT protocol, providing real-time data synchronization and remote device control capabilities.

✨ Key Features

🏡 Multi-Greenhouse Management

Create and manage multiple greenhouses
Track greenhouse location, crop type, and planting dates
View comprehensive greenhouse analytics and insights
Configure automation settings per greenhouse

📡 IoT Device Integration

Connect multiple IoT devices to each greenhouse
Real-time sensor data monitoring:
- Temperature (°C)
- Humidity (%)
- Soil Moisture (%)
- pH Levels
- Nitrogen (N) levels
Device status tracking (online/offline, battery level, last seen)
Secure device authentication using AWS IoT certificates

🔧 Automated Control Systems

Remote device control via MQTT
Automated irrigation based on soil moisture
Climate control (ventilation, temperature regulation)
Configurable target parameters for each greenhouse
Real-time command execution and status updates

🤖 AI-Powered Assistance

AWS Lex Integration: Conversational AI chatbot for farming queries
Perplexity AI Integration: Advanced fertilizer recommendations based on:
- Current crop stage
- Sensor readings (temperature, humidity, soil conditions)
- Days since planting
- VPD (Vapor Pressure Deficit) calculations
- Evapotranspiration (ET₀) metrics

📊 Advanced Analytics

Real-time sensor data visualization with charts
Historical data analysis and trends
Crop stage tracking with growth insights
Environmental condition monitoring
Fertilizer recommendations tailored to crop needs

🌤️ Weather Integration

Real-time weather data using WeatherAPI
7-day weather forecasts
Air quality index (AQI) monitoring
Weather alerts and notifications

👤 User Management

Secure authentication with AWS Cognito
User profile management with cloud storage
Multi-device synchronization
Custom notification preferences

🏗️ Architecture

The application follows Clean Architecture principles with clear separation of concerns:

├── Domain Layer (Business Logic)
│   ├── Entities (Core business models)
│   ├── Repositories (Abstract interfaces)
│   └── Use Cases (Business rules)
│
├── Data Layer (Data Management)
│   ├── Data Sources (Remote/Local data sources)
│   ├── Models (Data transfer objects)
│   ├── Repositories (Implementation)
│   └── Services (Business services)
│
├── Presentation Layer (UI)
│   ├── BLoC (State management)
│   ├── Pages (Screen widgets)
│   └── Widgets (Reusable UI components)
│
└── Config Layer
    ├── Dependency Injection (GetIt)
    ├── Routing (GoRouter)
    └── Theme

State Management: BLoC (Business Logic Component) pattern Dependency Injection: GetIt for service locator pattern

🛠️ Technical Stack

Frontend

Framework: Flutter 3.24.4 (Stable)
Language: Dart 3.5.4
UI Components: Material Design 3
State Management: flutter_bloc 9.1.1
Navigation: go_router 16.2.5
Local Storage: Isar 3.1.0

Backend & Cloud Services

Authentication: AWS Amplify Auth (Cognito)
Database: AWS Amplify DataStore (DynamoDB)
API: AWS Amplify API (AppSync GraphQL)
IoT: AWS IoT Core with MQTT
Storage: AWS S3 (via Amplify Storage)
AI Services:
- AWS Lex (Conversational AI)
- Perplexity AI (Agricultural recommendations)

Communication Protocols

MQTT: Secure IoT device communication (mqtt_client 10.11.1)
REST API: HTTP requests (dio 5.9.0)
GraphQL: AWS AppSync for data synchronization
WebSocket: Real-time data streaming

Build Tools

Android: Gradle 8.x with Kotlin DSL
iOS: CocoaPods (native dependencies)
Amplify: AWS Amplify Gen 2 with TypeScript

☁ AWS Services Integration

1. AWS IoT Core

Secure MQTT broker for device-to-cloud communication
Device certificate management and authentication
Topic-based pub/sub messaging
Real-time sensor data streaming

Implementation Details:

- Endpoint: AWS IoT Core endpoint (region: ap-southeast-1)
- Protocol: MQTT over TLS (port 8883)
- Authentication: X.509 certificates per device
- Topics: Custom topics based on device keywords

2. AWS Cognito

User authentication and authorization
Email-based sign-up and sign-in
Password reset and account recovery
JWT token management for API access

3. AWS AppSync (GraphQL)

Real-time data synchronization
Offline-first capabilities
Automatic conflict resolution
Fine-grained authorization rules

Data Models:

UserProfile: User account and preferences
Greenhouse: Greenhouse configurations
Device: IoT device metadata and certificates
SensorReading: Time-series sensor data

4. Amazon DynamoDB

NoSQL database for structured data
Global Secondary Indexes (GSI) for efficient queries
Time-series data storage for sensor readings
Automatic scaling and high availability

5. AWS Lex

Conversational AI for farming assistance
Natural language understanding (NLU)
Context-aware responses
Integration with greenhouse data for personalized advice

6. Amazon S3

Profile image storage
Document uploads
Backup and archival storage

📁 Project Structure

lib/
├── config/                          # App configuration, DI, routing, theme
├── core/                            # Core utilities, error handling, base classes
├── data/                            # Data layer implementation
│   ├── datasources/                 # API, AWS services, IoT communication
│   ├── models/                      # Data models
│   ├── repositories/                # Repository implementations
│   └── services/                    # Business services
├── domain/                          # Business logic layer
│   ├── entities/                    # Core business entities
│   ├── repositories/                # Repository interfaces
│   └── usecases/                    # Business use cases
├── presentation/                    # UI layer
│   ├── blocs/                       # State management (BLoC)
│   ├── pages/                       # Screen widgets
│   └── widgets/                     # Reusable UI components
├── amplify_outputs.dart             # Auto-generated Amplify config
└── main.dart                        # App entry point

amplify/                             # AWS Amplify backend configuration
├── auth/                            # Cognito auth setup
├── data/                            # AppSync GraphQL schema
└── backend.ts                       # Backend definition

📱 IoT Device Integration

Device Requirements

IoT devices must support:

MQTT protocol over TLS
X.509 certificate authentication
JSON payload format
Sensor data publishing

Device Registration

Add Device in App
- Navigate to greenhouse detail page
- Tap "Add Device" button
- Enter device name and pub/sub keyword
- Device certificates are automatically generated
Configure Device Certificates
- Device receives CA certificate, device certificate, and private key
- Store certificates securely on the device
- Use certificates for AWS IoT Core connection

MQTT Topics

Publish (Device → Cloud): <pubsubKeyword>/sensor_data
Subscribe (Cloud → Device): <pubsubKeyword>/commands

Sensor Data Format

Devices should publish JSON payloads:

{
  "deviceId": "device-uuid",
  "greenhouseId": "greenhouse-uuid",
  "temperature": 25.5,
  "humidity": 65.0,
  "soilMoisture": 45.0,
  "phLevel": 6.8,
  "nitrogen": 120.0,
  "timestamp": "2025-12-06T10:30:00Z"
}

Command Format

App sends control commands:

{
  "command": "irrigate",
  "duration": 120,
  "timestamp": "2025-12-06T10:30:00Z"
}

📖 Usage

1. Authentication

Sign up with email and password
Verify email with OTP
Sign in to access dashboard

2. Create Greenhouse

Tap "Add Greenhouse" from dashboard
Fill in greenhouse details (name, location, crop type)
Set automation preferences
Configure target environmental parameters

3. Add IoT Devices

Open greenhouse detail page
Add device with unique pub/sub keyword
Device certificates are generated automatically
Configure device with certificates

4. Monitor Real-Time Data

View live sensor readings on greenhouse page
Switch between Overview, Analytics, and Insights tabs
Monitor device status (online/offline)
View historical data with charts

5. Control Devices

Send manual commands to devices
Enable/disable automation rules
Configure irrigation schedules
Adjust climate control settings

6. AI Assistance

Open chat page for AI farming advisor
Ask questions about crop management
Get personalized recommendations
View fertilizer suggestions based on current data

7. Weather Monitoring

Check current weather conditions
View 7-day forecast
Monitor air quality
Plan farming activities accordingly

🧪 Key Dependencies

Package	Version	Purpose
`flutter_bloc`	^9.1.1	State management
`get_it`	^8.2.0	Dependency injection
`go_router`	^16.2.5	Navigation
`amplify_flutter`	^2.7.0	AWS Amplify SDK
`mqtt_client`	^10.11.1	MQTT communication
`dio`	^5.9.0	HTTP client
`isar`	^3.1.0	Local database
`fl_chart`	^1.1.1	Data visualization
`perplexity_flutter`	^2.0.4	Perplexity AI integration
`equatable`	^2.0.7	Value equality
`dartz`	^0.10.1	Functional programming

📸 Screenshots

Authentication

Dashboard

Greenhouse Management

IoT Device Integration

AI Chatbot

Weather Monitoring

User Profile

📄 License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License.

✅ You can use, copy, and modify the code for non-commercial purposes
✅ You must give appropriate credit
❌ You cannot use this project for commercial purposes without permission

For full license details, see LICENSE.md or visit: https://creativecommons.org/licenses/by-nc/4.0/

Made with ❤️ for farmers worldwide

Version 1.0.0 | December 2025

Name		Name	Last commit message	Last commit date
Latest commit History 54 Commits
amplify		amplify
android		android
lib		lib
screenshots		screenshots
test		test
web		web
.gitignore		.gitignore
.metadata		.metadata
LICENSE.md		LICENSE.md
README.md		README.md
analysis_options.yaml		analysis_options.yaml
devtools_options.yaml		devtools_options.yaml
package-lock.json		package-lock.json
package.json		package.json
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml

Folders and files

Latest commit

History

Repository files navigation

Farmers - Smart Greenhouse Management System

📖 Table of Contents

🌱 Overview

✨ Key Features

🏡 Multi-Greenhouse Management

📡 IoT Device Integration

🔧 Automated Control Systems

🤖 AI-Powered Assistance

📊 Advanced Analytics

🌤️ Weather Integration

👤 User Management

🏗️ Architecture

🛠️ Technical Stack

Frontend

Backend & Cloud Services

Communication Protocols

Build Tools

☁ AWS Services Integration

1. AWS IoT Core

2. AWS Cognito

3. AWS AppSync (GraphQL)

4. Amazon DynamoDB

5. AWS Lex

6. Amazon S3

📁 Project Structure

📱 IoT Device Integration

Device Requirements

Device Registration

Sensor Data Format

Command Format

📖 Usage

1. Authentication

2. Create Greenhouse

3. Add IoT Devices

4. Monitor Real-Time Data

5. Control Devices

6. AI Assistance

7. Weather Monitoring

🧪 Key Dependencies

📸 Screenshots

Authentication

Dashboard

Greenhouse Management

IoT Device Integration

AI Chatbot

Weather Monitoring

User Profile

📄 License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages