🌍 Plantera Web

A comprehensive web application for real-time deforestation detection and environmental monitoring. Built with modern technologies to track, analyze, and combat deforestation through satellite imagery and machine learning.

---

📋 Table of Contents

• Overview
• Features
• Tech Stack
• Project Structure
• Getting Started
  • Prerequisites
  • Installation
  • Running the Application
• Development
• Contributing
• License

---

🎯 Overview

Plantera is an intelligent environmental monitoring platform designed to detect and track deforestation in real-time. By combining satellite imagery analysis with machine learning models, Plantera provides actionable insights for environmental conservation and land management.

---

✨ Features

• Real-Time Deforestation Detection - Automated analysis of satellite imagery to detect forest loss
• Interactive Dashboard - Visualize deforestation hotspots and trends over time
• Geographic Mapping - Integrated mapping interface for spatial analysis
• Data Analytics - Comprehensive charts and statistics for environmental monitoring
• Multi-Format Support - Handle various image formats and compression
• Responsive Design - Mobile-friendly interface for on-the-go monitoring

---

🛠 Tech Stack

Frontend (JavaScript - 96.4%)

• React 19 - Modern UI framework
• Vite - Lightning-fast build tool
• Tailwind CSS - Utility-first CSS framework
• Material-UI (MUI) - Premium React component library
• Recharts - Data visualization library
• Mapbox GL - Interactive mapping
• React Router - Client-side routing
• Axios - HTTP client
• Zustand - State management
• Zod - TypeScript-first schema validation

Backend (JavaScript/Python)

• Node.js - Runtime environment
• Express.js - Web framework
• Axios - HTTP requests

Machine Learning (Python - 3.4%)

• Satellite image processing
• Deforestation detection models
• Data analysis and processing

---

📁 Project Structure

Plantera-Web/
├── client/                          # Frontend application
│   ├── src/
│   ├── package.json
│   └── vite.config.js
├── server/                          # Backend API
│   ├── node_modules/
│   └── package.json
├── ml/                              # Machine learning models
│   └── Real-Time_Deforestation_Detection/
├── .gitignore
└── README.md                        # This file

---

🚀 Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v16.0.0 or higher)
• npm (v7.0.0 or higher) or yarn
• Python (v3.8 or higher) - for ML components

Installation

1. Clone the repository

   git clone https://github.com/The-Plantera/Plantera-Web.git
   cd Plantera-Web

2. Install Frontend Dependencies

   cd client
   npm install

3. Install Backend Dependencies

   cd ../server
   npm install

4. Install ML Dependencies (Optional)

   cd ../ml
   pip install -r requirements.txt

Running the Application

Development Mode

1. Start the Backend Server

   cd server
   npm run dev

   The API will be available at http://localhost:3000 (or configured port)

2. Start the Frontend Development Server (in a new terminal)

   cd client
   npm run dev

   The application will be available at http://localhost:5173

Production Build

1. Build the Frontend

   cd client
   npm run build

2. Build the Backend

   cd server
   npm run build

3. Preview the Build

   cd client
   npm run preview

---

💻 Development

Available Scripts

Client

• npm run dev - Start development server with HMR
• npm run build - Build for production
• npm run preview - Preview production build
• npm run lint - Run ESLint

Server

• npm run dev - Start development server
• npm run build - Build for production
• npm run start - Run production server

Code Quality

This project uses ESLint to maintain consistent code quality.

Run linting:

cd client
npm run lint

Key Technologies

• Vite for fast development and optimized builds
• React Hooks for state management
• Tailwind CSS for responsive, utility-first styling
• TypeScript support (via configuration)

---

📊 Language Composition

• JavaScript: 96.4% (Frontend & Backend)
• Python: 3.4% (Machine Learning)
• Other: 0.2%

---

🤝 Contributing

We welcome contributions from the community! To contribute:

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

Please ensure your code passes linting and follows the project's coding standards.

---

📝 License

This project is open source and available under the MIT License. See the LICENSE file for details.

---

📞 Support

For support, issues, or questions:

• Open an issue on GitHub Issues
• Contact the maintainers

---

🌱 Environmental Impact

Plantera is built with a mission to combat deforestation and promote environmental conservation. Every line of code contributes to monitoring and protecting our planet's forests.

---

Built with ❤️ by The Plantera Team