← Back to Projects

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