Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

99 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌱 EcoConnect

EcoConnect is a smart waste management and recycling platform that connects households with waste collectors to encourage sustainable waste disposal and resource recovery.

The platform allows users to register, submit waste pickup requests, browse recyclable waste categories, and track collection activities through a modern web interface.


πŸš€ Features

πŸ‘€ User Authentication

  • User Registration
  • Secure Login
  • JWT Authentication
  • Role-Based Access Control

🏠 Household Features

  • Create Waste Pickup Requests
  • View Personal Requests
  • Track Request Status
  • Manage Recyclable Waste

πŸš› Collector Features

  • Browse Available Pickup Requests
  • Accept Collection Requests
  • Manage Assigned Pickups
  • Update Collection Status

β™» Waste Categories

  • Coconut Shells
  • Coconut Husks
  • Plastic
  • Glass
  • Paper / Cardboard
  • Food Waste
  • General Disposal

πŸ“Š Dashboard

  • Request Overview
  • Pickup Statistics
  • Waste Tracking

πŸ“Έ Screenshots

Home Page

image

Circular Economy Categories

image

Collector Dashboard

image

Householder Dashboard

image

Marketplace

image image

Bookings

image

πŸ›  Tech Stack

Frontend

  • React
  • Vite
  • Tailwind CSS
  • React Router
  • Axios

Backend

  • FastAPI
  • SQLAlchemy
  • Pydantic
  • JWT Authentication

Database

  • SQLite

πŸ“‚ Project Structure

EcoConnect
β”‚
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ pages/
β”‚   └── services/
β”‚
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ routes/
β”‚   β”‚   β”œβ”€β”€ models/
β”‚   β”‚   β”œβ”€β”€ schemas/
β”‚   β”‚   └── database/
β”‚   β”‚
β”‚   β”œβ”€β”€ main.py
β”‚   └── requirements.txt
β”‚
└── README.md

βš™ Installation

Clone Repository

git clone https://github.com/Kalpiekanayake/EcoConnect.git

Backend Setup

cd backend

python -m venv venv

venv\Scripts\activate

pip install -r requirements.txt

uvicorn main:app --reload

Backend runs on:

http://127.0.0.1:8000

Frontend Setup

cd frontend

npm install

npm run dev

Frontend runs on:

http://localhost:5173

API Endpoints

Authentication

POST /auth/register
POST /auth/login

Users

GET /users
POST /users

Categories

GET /categories
POST /categories
POST /categories/seed

Waste Requests

GET /wastes
POST /wastes

Future Improvements

  • Google Maps Integration
  • Real-time Notifications
  • Mobile Application
  • Collector Route Optimization
  • Waste Analytics Dashboard
  • Cloud Database Deployment

Learning Outcomes

This project helped strengthen skills in:

  • Full Stack Development
  • REST API Design
  • Authentication & Authorization
  • Database Design
  • Frontend Routing
  • State Management
  • Software Architecture

Author

Kalpani Ekanayake

Software Engineering Undergraduate

GitHub: https://github.com/Kalpiekanayake

About

A full stack we application to manage coconut collection schedules with FastAPI backend and React frontend. Users can submit their available quantity and schedule, while collectors can plan optimized routes

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages