Skip to content

PeyalaAnandanaidu/GreenCollect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧩 Janatha Garage – Turning Trash into Treasure

A Smart E-Waste Collection & Rewards Platform that connects users, collectors, and admins to promote sustainable waste management through an efficient, tech-driven approach.


🧠 Problem Statement

Improper e-waste disposal remains a major challenge due to a lack of organized collection systems and incentives.

💡 Our Solution

Janatha Garage provides a digital platform where:

  • Users can request e-waste pickups.
  • Collectors are approved by the admin to handle and deliver waste to verified recycling centers.
  • Users earn reward coins that can be redeemed for eco-friendly products or services.
  • Collectors gain part-time employment, and admins oversee operations and rewards.

🌱 Why It Matters

  • Tackles unmanaged e-waste and plastic pollution.
  • Transforms waste into value through recycling and reward systems.
  • Empowers communities to take part in sustainability efforts.
  • Promotes transparency and accountability in waste management.
  • Contributes to a cleaner, greener, and more responsible future.

⚙️ Key Features

🧍 User Dashboard

  • Book waste pickups easily.
  • Track real-time collection status.
  • Earn and redeem reward coins.
  • View pickup and reward history.

🧺 Collector Dashboard

  • Accept and manage pickup requests.
  • Submit collected waste to verified recycling centers.
  • Track daily collections and earnings.

🛠️ Admin Dashboard

  • Manage users, collectors, and recycling centers.
  • Monitor all waste collection activities.
  • Approve collector registrations and verify submissions.
  • Oversee rewards, data, and platform performance.

🧰 Tech Stack

Area Technology
Frontend React + Vite + TypeScript
Backend Node.js + Express.js
Database MongoDB
Authentication JWT (JSON Web Token)
Architecture Client–Server Model with real-time updates and role-based dashboards

🌍 Impact

  • Cleaner Cities: Organized collection reduces pollution.
  • Motivated Citizens: Rewards inspire consistent recycling.
  • Transparency: Real-time tracking ensures accountability.

🚀 Scalability & Future Enhancements

  • AI-Based Route Optimization: Efficient pathfinding for collectors.
  • Municipal Integration: Connects with government systems for waste tracking.
  • Gamification: Leaderboards, badges, and milestones to encourage engagement.
  • Mobile App Version: Real-time notifications and seamless access.
  • AI Insights: Predictive analytics for waste patterns and optimization.

👥 Team Janatha Garage

Name Role
KSV Thanush Data and API Integration
Rajala Sasank Reddy Team Lead
Ashok Yekkanti Frontend Developer
Venkatesh Budhi Frontend Developer
Anand Peyala Backend Developer

“United by collaboration and purpose, our team lives by its motto — a people’s workshop working toward a sustainable tomorrow.”


⚙️ Setup Instructions

Follow these steps to set up and run the frontend locally.

🖥️ The backend is already deployed and connected.


🪜 1️⃣ Clone the Repository

git clone https://github.com/PeyalaAnandanaidu/GreenCollect.git
cd GreenCollect

### 🪜 2️⃣ Install Dependencies

Move into the frontend folder and install the required packages.

cd frontend
npm install

### 🪜 3️⃣ Run the Application

Start the frontend development server with:

npm run dev

Once it compiles successfully, open the link shown in the terminal (usually):

http://localhost:5173

### 🪜 🌍 4️⃣ Access the Application

After starting the frontend:

- The app will connect automatically to the **deployed backend**.
- You can now use all the key features of **Janatha Garage**, including:

  - 🧍 **User registration & login**
  - 🧾 **Waste pickup booking**
  - 🪙 **Reward tracking**
  - 🛠️ **Admin & collector management**

Once the app starts successfully, open it in your browser at:


> 💡 Make sure your internet connection is active so the frontend can communicate with the deployed backend API.


---

✅ **Preview (how it will look on GitHub):**

---

### 🪜 🧠 5️⃣ Troubleshooting

- ⚠️ **Port already in use:**  
  If you see this error, stop the current process by pressing **Ctrl + C** in the terminal, then rerun the command:
  ```bash
  npm run dev

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors