CarbonEye: Real-Time Deforestation Monitoring Platform

Eyes on the forest. Always.

📱 Download the App

🌐 Official Website

📄 API Docs Site (includes code samples and instructions on how to use our API)

⚠️ Hosted on Render's free tier — services may take up to 50 seconds to wake up when inactive.

Project Overview

CarbonEye is a powerful tool designed to provide real-time intelligence on deforestation activities across the globe. By leveraging satellite imagery analysis, it empowers users to monitor specific regions, receive timely alerts, and generate detailed impact reports for environmental, social, and governance (ESG) purposes.

The platform consists of three main parts:

• A powerful backend built with Node.js, responsible for the heavy lifting of fetching and analyzing satellite data.
• A cross-platform frontend application built with Flutter, providing a rich, interactive user experience for analysis on mobile (iOS/Android) and the web.
• An informational static website built with HTML, CSS, and JavaScript, which serves as the public landing page, providing project details, team information, and the user dashboard.

Full-Stack Architecture

The CarbonEye platform is built on a modern, decoupled architecture. The clients communicate with the backend via a REST API, allowing for independent development, deployment, and scaling of each component.

flowchart TB
    %% === Define Styles ===
    classDef user fill:#08427b,stroke:#002a52,stroke-width:2px,color:white
    classDef service fill:#1168bd,stroke:#0b4884,stroke-width:2px,color:white
    classDef core fill:#4f46e5,stroke:#3730a3,stroke-width:2px,color:white
    classDef external fill:#6b7280,stroke:#4b5563,stroke-width:2px,color:white

    %% === User Devices (Top Layer) ===
    subgraph UD["User Devices"]
        direction LR
        FlutterApp["Flutter App (iOS / Android)"]
        StaticWeb["Web Dashboard (HTML / CSS / JS)"]
        class FlutterApp,StaticWeb user
    end
    UD -->|API Request| APIGateway
    APIGateway -->|Deliver Response| UD

    %% === CarbonEye Backend (Middle Layer) ===
    subgraph BE["CarbonEye Backend"]
        direction TB
        APIGateway["API Gateway (FastAPI)<br><sub>Handles all incoming requests</sub>"]
        AnalysisService["Analysis Service<br><sub>Orchestrates deforestation analysis</sub>"]
        ImageProcessor["Image Processing & ML<br><sub>NDVI, change detection, severity</sub>"]
        NotificationService["Notification Service<br><sub>Sends alerts to users</sub>"]
        class APIGateway,AnalysisService,NotificationService service
        class ImageProcessor core
    end

    %% === External Services (Bottom Layer) ===
    subgraph EX["External Services"]
        direction LR
        SatelliteProvider["Satellite Provider<br><sub>e.g., Sentinel Hub</sub>"]
        EmailProvider["Email Service<br><sub>e.g., SendGrid</sub>"]
        class SatelliteProvider,EmailProvider external
    end

    %% === Backend Flow ===
    APIGateway -->|Forward to Analysis| AnalysisService
    AnalysisService -->|Send to Gateway| APIGateway

    AnalysisService -->|Request Imagery| SatelliteProvider
    SatelliteProvider -->|Return Imagery| AnalysisService

    AnalysisService -->|Send for Processing| ImageProcessor
    ImageProcessor -->|Return Results| AnalysisService

    AnalysisService -->|Trigger Alert| NotificationService
    NotificationService -->|Send Email| EmailProvider

Loading

Features

• Cross-Platform Client: A Flutter application for Android, iOS, and Web for in-depth analysis.
• Public-Facing Website: An informational website with project details, team bios, and a user dashboard.
• Real-time Analysis: On-demand deforestation analysis of user-selected regions.
• Interactive Map Interface: Users can pan, zoom, and select a bounding box to define an area for analysis.
• Data Visualization: Displays true-color and NDVI satellite imagery for "before" and "after" comparison.
• Alerts & Watchlist: Visualizes critical deforestation alerts on the map and allows users to save locations to a watchlist.
• Annotation Tools: Users can add timestamped notes and observations to their monitored regions.
• Comprehensive PDF Reporting: Generates professional PDF reports summarizing the analysis for ESG documentation.
• Microservice-Ready Backend: A scalable Node.js backend handles all data processing and analysis.

Technology Stack

Component	Technology/Package	Description
Frontend	Flutter	Cross-platform UI toolkit for the analysis application.
	http	For making API requests to the backend.
	flutter_map	For the interactive map interface.
	pdf & printing	To create and share PDF reports.
	HTML5, CSS3, JS (ES6)	For the public-facing informational website and dashboard.
Backend	Node.js	JavaScript runtime for the server.
	Express	Web framework for Node.js, used for the API Gateway.
	dotenv	For managing environment variables.
	cors	For enabling Cross-Origin Resource Sharing.
External	Sentinel Hub	Provides the core satellite imagery data.
	SendGrid	Example email provider for sending notifications.

🛠️ Full-Stack Setup and Installation

To run the complete CarbonEye platform, you must set up the backend and the desired frontend client(s).

Prerequisites

• Node.js (v14 or higher) & npm
• Flutter SDK (v3.0 or higher) & Dart SDK
• An IDE like VS Code or Android Studio
• A Sentinel Hub account to obtain CLIENT_ID and CLIENT_SECRET

1. Backend Setup

First, set up and run the server.

1. Navigate to the backend directory:

   cd carboneye/backend

2. Install backend dependencies:

   npm install

3. Configure environment variables: Create a .env file in the backend directory.

   CLIENT_ID='YOUR_SENTINEL_HUB_CLIENT_ID'
   CLIENT_SECRET='YOUR_SENTINEL_HUB_CLIENT_SECRET'
   PORT=3000
   

2. Frontend Setup

A. Flutter Application (for Mobile & Web Analysis)

Set up the cross-platform application.

1. Navigate to the project root directory:

   cd carboneye

2. Install frontend dependencies:

   flutter pub get

3. Configure the Backend URL: Open the lib/config.dart file and update the API_BASE_URL to point to your backend.

   // lib/config.dart
   const String API_BASE_URL = 'http://<YOUR_LOCAL_IP_OR_HOSTNAME>:3000';

   Important: When running on a mobile emulator/device, you must use your computer's local network IP address (e.g., 192.168.1.10) instead of localhost.

B. Static Website (Informational Site & Dashboard)

The static website requires no build process. It is located in the CarbonEye-anant directory.

• Structure: The site is composed of standard HTML, CSS, and JavaScript files.
  • index.html: The main landing page.
  • dashboard/: Contains the user dashboard.
  • about/, team/, etc.: Informational sub-pages.
  • style.css, script.js: Main stylesheets and scripts.

Running the Full Application

1. Start the Backend Server: In your terminal, from the carboneye/backend directory, run:

   npm start

   The server will start on port 3000 (or the port specified in your .env file).

2. Run the Frontend Application(s):

   • Flutter App: In a new terminal, from the root carboneye directory, select your target device (Chrome, Emulator, etc.) and run:

     flutter run

   • Static Website: Simply open the CarbonEye-anant/index.html file in your web browser. For full functionality (like API calls from the dashboard), it's best to serve the directory using a simple local server. If you have Python installed, you can run this from the CarbonEye-anant directory:

     # Python 3.x
     python -m http.server

     Then navigate to http://localhost:8000 in your browser.

⚙️ Backend API Endpoints

/analyze-deforestation

• Method: POST
• Description: Analyzes a specified region for deforestation.
• Request Body:

  {
    "bbox": [ -62.41, -3.66, -62.01, -3.26 ]
  }

• Success Response (200 OK): Returns a JSON object with true-color images, NDVI maps, alerts, and analysis summary.
• Error Responses: Returns 400 for invalid input or 500 for server errors.

Building for Production

Flutter Application

To create a release build of the application, use the following Flutter CLI commands from the project root.

• Android (APK):

  flutter build apk --release

  The output will be located at build/app/outputs/flutter-apk/app-release.apk.
• iOS:

  flutter build ios --release

  This requires a configured Xcode environment.
• Web:

  flutter build web

  The compiled web application will be in the build/web directory.

Static Website

The static website is already "built". To deploy it, simply copy the entire contents of the CarbonEye-anant directory to a static web hosting service (like Netlify, Vercel, or AWS S3).

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Created by

Akshat Singh, Abhay Singh, Amaan Ali, Anant Singhal