Skip to content

Repository files navigation

🧭 Campus Lost & Found

A smarter way to recover lost items on campus

Misplacing something on campus shouldn’t turn into a full investigation. Campus Lost & Found is a lightweight web platform that helps students report, search, and recover lost items quickly using real-time data and AI-powered matching.


🚀 Live Demo

🌐 https://campuslostandfound-f09d7.web.app/


🔍 Overview

This project provides a simple and centralized platform where users can:

  • Report lost or found items
  • Browse listings in real-time
  • Search using keywords or descriptions
  • Get AI-assisted matches for better recovery chances

The goal is to reduce time, effort, and confusion in recovering lost belongings.


✨ Features

  • 📝 Quick reporting of lost and found items
  • 🔍 Search and filter listings
  • 🧠 AI-based similarity matching (Gemini API)
  • 🖼 Optional image upload
  • 🔐 Anonymous posting option
  • 📡 Real-time updates with Firebase
  • 📱 Responsive design (mobile + desktop)
  • ⚡ Fast and minimal frontend

🧠 Tech Stack

Layer Technology
Frontend Vite, Vanilla JavaScript, CSS
Backend Firebase (optional functions)
Database Firebase Firestore
Hosting Firebase Hosting
AI Gemini API (Google AI)

⚙️ How It Works

  1. Users submit a lost or found item
  2. Data is stored in Firebase Firestore
  3. Listings update in real-time
  4. Gemini API analyzes descriptions to suggest similar items
  5. Users connect and recover items

👥 Usage

Users

  • Post lost or found items
  • Search listings
  • Share contact details or remain anonymous

Admin (Optional)

  • Moderate posts
  • Remove spam or irrelevant entries

🧪 AI Integration

Gemini API is used to:

  • Compare item descriptions
  • Suggest similar listings
  • Improve match accuracy
  • Reduce manual search effort

🛣️ Future Improvements

  • 📍 Location-based filtering
  • 🔔 Notifications for matched items
  • 🔐 User authentication
  • 🗂️ Better categorization and filters
  • 🌐 Multi-language support
  • 📱 Progressive Web App (PWA)

💡 Why This Project

Most campus lost-and-found systems are either offline or poorly organized. This project focuses on:

  • Simplicity
  • Accessibility
  • Real-time updates
  • Useful AI integration

🧾 Summary

A practical solution built with modern tools:

  • Real-time database
  • Clean frontend
  • AI-assisted matching

Simple, functional, and actually useful.

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages