Skip to content

ayarigab/lofo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Downloads (all assets, all releases) GitHub Sponsors Latest Stable Version License

๐Ÿ“ฆ LoFo - Lost & Found System

1750957963592

Lost it, found it.


๐Ÿ” Overview

LoFo (short for Lost Found ) is a modern, elegant, and fully responsive web application designed to help users report lost items and find missing belongings within their community. Built with the power of Laravel, Livewire, Alpine.js, and Tailwind CSS , LoFo offers a seamless experience for individuals to connect and reunite lost items with their rightful owners.

This system is ideal for campuses, offices, communities, or public spaces where people frequently lose or find items and want an organized way to report and track them.

๐Ÿ“ธ Screenshots

1750958679943 1750958694146
1750958702727 1750958711218
1750958718853 1750958725043
1750958745643 1750958752121
1750958792544 1750958807041

๐Ÿ’ก Features

  1. ๐Ÿงพ Report Lost Items: Users can submit detailed reports including item name, description, location, date, and photos.
  2. ๐Ÿ“ธ Multi-image Upload: Support for uploading multiple images to help identify the lost/found item clearly.
  3. ๐Ÿ” Search & Filter: Powerful search functionality to look up lost or found items by category, date, or keywords.
  4. ๐Ÿ“จ Contact Form: A built-in messaging system that allows users to send inquiries or suggestions directly to the admin.
  5. ๐Ÿ‘ค Dual Login System: Separate login systems for **Admins **and **Claimers **using Laravel’s authentication guards.
  6. ๐Ÿ›  Admin Dashboard: For managing reported items, messages, and claim requests.
  7. ๐Ÿ“ฑ Responsive Design: Fully mobile-friendly interface using Tailwind CSS.
  8. ๐ŸŽจ Interactive UI/UX: Powered by **Alpine.js **for dynamic interactions and **Livewire **for real-time updates without full page reloads.

๐Ÿงฐ Technology Stack

Backend Laravel 12+, PHP 8+
Frontend Livewire, Alpine.js, Tailwind CSS
Database MySQL / PostgreSQL

๐Ÿงฉ Core Modules

1. User Module

  • Sign Up / Register
  • Login / Logout
  • Profile Management
  • Email Notifications

2. Item Reporting Module

  • Submit a lost or found item
  • Upload multiple images
  • Categorize items (e.g., Electronics, Clothing, Accessories)
  • Track item status (Pending, Claimed)

3. Search Module

  • Real-time search
  • Advanced filters: Date, Category, Location

4. Messaging Module

  • Contact form for sending messages to admins

Prerequisites

  • PHP 8.1+
  • Composer
  • Node.js & npm
  • MySQL or PostgreSQL

Installation

git clone https://github.com/ayarigab/lofo.git
cd lofo

# Install dependencies
composer install
npm install && npm run build

# Setup environment
cp .env.example .env
php artisan key:generate

# Configure database in .env, then:
php artisan migrate --seed

# Serve the app
composer run dev

๐Ÿ“ฆ Deployment

LoFo is deployable on any standard Laravel hosting platform:

  • **Vercel + Laravel Zero ** (serverless ready)
  • Laravel Forge
  • Heroku
  • DigitalOcean App Platform
  • Shared Hosting (with proper setup)

๐Ÿง‘‍๐Ÿ’ป Contributing

We welcome contributions.

๐ŸŽ‰ Acknowledgments

Built with โค๏ธ using:


๐Ÿš€ Coming Soon

  • ๐Ÿ” Email verification & password reset
  • ๐Ÿ“ฌ Admin email alerts for new item reports
  • ๐Ÿ“Š Analytics dashboard for lost item trends
  • ๐ŸŒ Google Maps integration for item locations
  • ๐Ÿงญ Items tracking
  • Modularity and theming support.
  • Flutter Mobile Application
  • API routes.

About

Lost and Found Systems LLC

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors