Green Ecolution Frontend 🌿

Important

This repository has been archived.
Active development of the Green Ecolution frontend now continues in the unified green-ecolution/green-ecolution monorepo.
This repository is no longer maintained — please use the new repository for all future contributions and issues.

Smart irrigation is essential to saving water, reducing staff workload, and cutting costs. This project provides the user interface for Green Ecolution — a digital system to manage urban greenery efficiently.

👉 For the backend implementation, visit the Green Ecolution Backend.

The frontend connects to the backend and enables users to interact with:

• 🌳 Trees
• 🌿 Tree clusters
• 📡 Sensors
• 🗺️ Watering plans
• 🚛 Vehicles
• 👤 Users

Developed in collaboration with TBZ Flensburg, this software is designed to be adaptable for other cities. It originated as a research project within the Applied Computer Science Master's program at the University of Applied Sciences Flensburg.

For further information, visit:

• 🌐 Project website
• 🎓 University of Applied Sciences Flensburg
• 🖥️ Live demo

Technologies Used ⚙️

• React
• Vite for fast development and HMR
• TypeScript
• ESLint for code linting
• PnPM for dependency management
• fnm for Node.js version management

Local development 💻

Requirements

• Node.js
• PnPM
• fnm

Initial Setup ⚙️

1. Install the required Node.js version:

fnm use

2. Install pnpm globally: https://pnpm.io/installation

3. Install dependencies:

pnpm install

Running the Project ▶️

Build the local backend-client and start the frontend:

pnpm generate:local
pnpm rebuild
pnpm dev

By default, the app connects to the local running backend localhost:3000. If you want to use the deployed stage backend instance instead, adjust the VITE_BACKEND_BASEURL environment variable:

pnpm dev:remote

How to Contribute 🤝

We welcome contributions! Please follow these guidelines:

1. Fork this repository.
2. Create a topic branch off develop.
3. Commit your changes.
4. Push your branch to your fork.
5. Open a Pull Request.

This project follows:

• Git-Flow Workflow for branching and releases.
• Conventional Commits for commit messages.

Thank you for helping us improve Green Ecolution! 🌿