← Back to Projects
finderHub - Lost & Found Community Platform

finderHub - Lost & Found Community Platform

A full-stack community platform for reporting, tracking, and recovering lost and found items. Built with React, Node.js, Express, and MongoDB.

ReactTailwindCSSReact QueryNode JSMongo DBMongooseCloudinary

About This Project

Features: - User registration and login with JWT-based authentication (access + refresh tokens) - Password reset via email using Nodemailer with Gmail App Passwords - Role-based access control with three roles: User, Staff, and Admin - Report lost or found items with title, description, category, location, district, date, and contact info - Image uploads via Cloudinary (up to 5 images per item, 10MB each) - Smart match detection that automatically searches for potential matches when an item is reported - Advanced search and filtering by type, category, district, status, and keywords - Claims system with verification document uploads (images and PDFs) - Staff claim review workflow with approve/reject actions and automatic rejection of other pending claims - Real-time notifications for claim updates, match alerts, and status changes - Police handover tracking for unclaimed found items older than 30 days with report number logging - User dashboard with personal item and claim statistics - Staff dashboard with branch-level item management, claim processing, and location-based analytics - Admin panel with user management, role assignment, bulk item operations, system analytics, and data export (JSON/CSV) - Item expiry system that automatically marks items as expired after 30 days - Pagination across all list views - Responsive UI built with Tailwind CSS - Security hardening with Helmet headers, rate limiting, input validation, NoSQL injection protection, and token revocation on user deactivation - Error boundary for graceful frontend error handling