FoundIt

Lost-and-Found Web Application

Overview

FoundIt is a robust lost-and-found web application that enables users to report and discover lost or found items within a community. It features a modern Vue.js frontend and a Laravel API backend, offering real-time notifications, image classification, and powerful search capabilities.

Features

• Create and manage lost item reports
• Create and manage found item reports
• Browse and search items by category or keywords
• Real-time notifications via Pusher and Laravel Echo
• Image classification powered by TensorFlow.js (MobileNet & KNN classifier)
• Full-text search using Laravel Scout and MeiliSearch
• Secure authentication with JWT
• Responsive design with Tailwind CSS

Architecture

This project follows a decoupled architecture:

• Frontend: Vue.js Single Page Application (SPA) built with Vite
• Backend: Laravel RESTful API
• Database: PostgreSQL
• Broadcasting: Pusher (backend uses pusher-php-server; frontend uses Laravel Echo & Pusher JS)
• Search: MeiliSearch via Laravel Scout

Tech Stack

Frontend

• Vue.js 3.x
• Vite
• Pinia for state management
• Vue Router
• Tailwind CSS, PostCSS, Autoprefixer
• Axios (HTTP client)
• Laravel Echo & Pusher JS
• Vue3-Toastify (notification alerts)
• Lucide Vue Next (icons)
• Date-fns (date utilities)
• @tensorflow/tfjs, @tensorflow-models/mobilenet, @tensorflow-models/knn-classifier (image classification)

Backend

• PHP 8.1+
• Laravel 10
• tymon/jwt-auth (authentication)
• Laravel Scout & meilisearch-php (search)
• Pusher PHP Server (broadcasting)
• GuzzleHTTP (HTTP client)
• PHPUnit, Mockery (testing)
• Laravel Pint (code style)

License

This project is licensed under the MIT License. See LICENSE for details.