TrashSync - Waste Collection Management System with Express.js REST API & React Js

TrashSync – Waste Collection Management System with Express.js REST API & React Js

trashsync is a comprehensive waste collection management System built with an Express.js REST API backend and a React frontend. It streamlines waste collection, routing, and operations with role-based access, reporting, and document management. Ideal for municipalities, waste management companies, and environmental organizations. Secured with JWT for stateless authentication.

Key Features

• Waste Management: Track types, quantities, and collection records in real time.
• Bin Management: Monitor and manage waste bins, including location, capacity, and fill-level status.
• Staff & Drivers: Assign staff, manage attendance and documents with role-based access.
• Vehicle Management: Track vehicles, maintenance logs, and documents.
• Routes & Zones: Create zones and assign routes for efficient collections.
• Reports & Analytics: Waste, vehicle, and staff reports with charts and exports (XLSX/PDF).
• Settings: Company branding, SMTP configuration, and system alerts.
• Modern API: Express.js REST API with Drizzle ORM for type-safe SQL.
• Responsive Design: Fully responsive UI, compatible with desktops, tablets, and mobile devices.
• Easy Integration: Clean REST API for third-party integrations.
• Secure Authentication: JWT provides lightweight, stateless authentication for secure API access.

Highlights

• Clean architecture (controllers, services, validators) for maintainability
• Robust validation with Zod (server-side), friendly error messages
• File uploads with magic-number verification (anti-mime spoofing)
• Rate limiting on auth and API endpoints to mitigate abuse
• Charts, CSV/XLSX/PDF export for management reporting

Modules

• Dashboard & KPIs
• Waste Collection (CRUD, schedule, status)
• Bins (CRUD, assignment)
• Zones & Routes (planning, assignments)
• Vehicles (documents, maintenance logs)
• Staff (attendance, documents, route assignment)
• Reports (waste, vehicle, staff, waste types)
• System Settings (company, SMTP, alerts)

Why Choose trashsync?

• Modern stack: Express 5, React, Drizzle ORM, MySQL.
• Secure: JWT auth, validation, rate limiting, XSS sanitization, file signature checks.
• Production ready: clear docs, environment templates, and build steps.
• Extensible: modular services, validators, and routes.

Live Demo

• Open Admin Demo
• Email: admin@trashsync.app
• Password: Admin@12345

System Requirements

Backend

• Node.js 18+ (LTS) or 20+
• npm 9+ or Yarn
• MySQL 8+
• Express.js 5
• Drizzle ORM

Frontend

• Node.js 18+ or 20+
• npm or Yarn
• React 19

Technology Stack

Backend Technologies

• Express.js: Fast, unopinionated web framework for Node.js
• Drizzle ORM: Modern, performant SQL ORM for JavaScript
• MySQL2: Fast MySQL driver for Node.js
• JWT: JSON Web Tokens for secure authentication
• JavaScript: Modern JavaScript (ES6+) development

Frontend Technologies

• React 19: UI library for building the dashboard
• JavaScript: Modern JavaScript (ES6+)
• Bootstrap: Responsive design

What’s Included

• Full source code: backend (Express) and frontend (React)
• Environment examples and documentation
• SQL dump (database.sql) or Drizzle migration + seed scripts
• Postman collection (API examples)

Quick Installation Overview

1. Backend: npm install → configure .env → import database.sql or run npm run db:migrate & npm run db:seed → npm run dev
2. Frontend: npm install → set VITE_API_BASE_URL in .env → npm run dev or npm run build

FAQs

Can I use a different database?

trashsync ships with MySQL. Porting to another SQL engine is possible with Drizzle ORM but not officially supported in this item.

Does it include mobile apps?

No. This item includes a React web admin and an Express API. Mobile apps are not included.

Can I brand it for my client?

Yes. You can change logos, colors, and system name in settings and the UI.

Support

Need help? Contact: nwebdeveloper53@gmail.com