Skip to content

Ritesh-251/lostandfound

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

79 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ’ Lost & Found Portal

A full-stack web application that helps users find their lost items or report found items in a college campus or any public space.


πŸš€ Features

  • πŸ” Search lost items using item type or description
  • πŸ”” Get notified via email when an item from your selected category is found
  • πŸ“ Submit found item with images and verification questions
  • πŸ‘€ View item details securely before claiming
  • πŸ“¬ Claim item with contact details and answers to verification questions
  • βœ… Admin dashboard to approve/reject claims
  • πŸ” JWT-based Authentication
  • πŸ“§ Email notifications for new item matches and claim updates

βš™οΈ How It Works

  1. Users can search for items using keywords.
  2. If they don’t find their item, they can subscribe for email alerts by selecting a category (e.g., "Electronics").
  3. Users who find items can submit them with photos and verification questions.
  4. Other users can then claim these items by answering the questions and entering their details.
  5. The admin panel lets owners approve or reject these claims.
  6. All major actions (like new match, claim approval) trigger emails.

πŸ”§ Tech Stack

Frontend:

  • React.js
  • Tailwind CSS
  • ShadCN UI
  • Axios

Backend:

  • Node.js
  • Express.js
  • MongoDB + Mongoose
  • Cloudinary (for image storage)
  • Gmail SMTP (for sending emails)
  • JWT (for login sessions)

πŸ“¬ Email Notifications

The app sends transactional emails through Gmail SMTP, including:

  • βœ… Confirmation when a user subscribes for item notifications
  • πŸ“© Alerts when a matching item is found
  • πŸ“¬ Updates when a claim is approved or rejected

⚠️ Make sure to enable "Less secure app access" or set up an App Password for Gmail to allow email sending from your backend.


πŸ™Œ Contribution

Feel free to fork and improve! Pull requests are welcome.
Built with ❀️ by Ritesh and Krishna to help people find their stuff easily.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages