Skip to content

siddiqui7864/Findora

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

11 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ“ Findora

Lost something on campus? We'll help you find it.

A real-time campus lost & found portal that connects students with their missing belongings โ€” no sign-ups, no downloads, just open and search.


๐Ÿง  The Problem

Every college campus deals with the same frustrating cycle:

A student loses something โ†’ They ask around โ†’ Nobody knows โ†’ The item sits unclaimed in a random office โ†’ It's eventually thrown away.

  • There's no centralized system for reporting or finding lost items.
  • WhatsApp groups and notice boards are chaotic, unsearchable, and quickly buried.
  • Students on different devices can't see what others have reported.
  • Staff have no way to manage or track item statuses.

Result: Hundreds of recoverable items go unclaimed every semester.


๐Ÿ’ก Our Solution

Findora is a real-time, cloud-synced lost and found web portal designed specifically for college campuses.

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   ๐Ÿ“ Report  โ”‚  โ”€โ”€โ”€โ–ถ โ”‚  ๐Ÿ” Search &     โ”‚  โ”€โ”€โ”€โ–ถ โ”‚  ๐Ÿค Reunite  โ”‚
โ”‚   Lost/Found โ”‚       โ”‚     Filter       โ”‚       โ”‚   & Claim    โ”‚
โ”‚     Item     โ”‚       โ”‚   Instantly      โ”‚       โ”‚  Your Item   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  • Students report lost/found items with photos, categories, and location details
  • Everyone can search and filter listings in real-time โ€” no refresh needed
  • Admins manage all submissions through a dedicated dashboard
  • Zero friction โ€” no login required for students, works on any device

๐Ÿš€ Key Features

Feature What It Does
โšก Real-Time Sync All reports instantly appear on every user's screen via Supabase Realtime
๐Ÿ” Smart Search Search across item names, descriptions, and categories simultaneously
๐Ÿ—‚๏ธ Advanced Filters Filter by status, category, location, and date range
๐Ÿ“ธ Photo Upload Drag-and-drop image upload with cloud storage
๐Ÿ“Œ Status Lifecycle Track items: Lost โ†’ Found โ†’ Claimed
๐Ÿ” Admin Panel Password-protected dashboard with stats, bulk actions, and item management
๐Ÿท๏ธ Quick Tags One-click popular search tags (Phone, Wallet, Laptop, Keys, ID Card)
๐Ÿ“ฑ Fully Responsive Works seamlessly on desktop, tablet, and mobile
๐ŸŒ™ Premium Dark UI Glassmorphism, gradient accents, and micro-animations
๐Ÿ”” Toast Notifications Beautiful feedback on every user action

๐Ÿ› ๏ธ Tech Stack

Layer Technology Why We Chose It
Frontend HTML5, CSS3, JavaScript (ES6+) Zero build tools = instant deployment, no complexity
Database Supabase PostgreSQL Free tier, real-time subscriptions, REST API out of the box
Real-Time Supabase Realtime Postgres Changes for live sync without WebSocket boilerplate
Storage Supabase Storage Public bucket for item photos with CDN-backed URLs
Design Inter (Google Fonts), Font Awesome 6 Modern typography + comprehensive icon set

Why no framework? We intentionally built with vanilla HTML/CSS/JS to prove that a polished, production-grade app doesn't need React, Next.js, or any bundler. The entire project is under 10 files and deploys by simply opening index.html.


๐Ÿ—๏ธ Architecture

                    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                    โ”‚      Supabase Cloud      โ”‚
                    โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚
                    โ”‚  โ”‚ Postgresโ”‚ โ”‚Storage โ”‚  โ”‚
                    โ”‚  โ”‚   DB    โ”‚ โ”‚(Images)โ”‚  โ”‚
                    โ”‚  โ””โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”˜  โ”‚
                    โ”‚       โ”‚          โ”‚       โ”‚
                    โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”  โ”‚
                    โ”‚  โ”‚  Realtime Engine   โ”‚  โ”‚
                    โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜  โ”‚
                    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                โ”‚
              โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
              โ”‚                 โ”‚                 โ”‚
        โ”Œโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”   โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”   โ”Œโ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”
        โ”‚  Student   โ”‚   โ”‚  Student    โ”‚   โ”‚   Admin   โ”‚
        โ”‚  Browser 1 โ”‚   โ”‚  Browser 2  โ”‚   โ”‚  Browser  โ”‚
        โ”‚ index.html โ”‚   โ”‚ index.html  โ”‚   โ”‚ admin.htmlโ”‚
        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
              โ–ฒ                โ–ฒ                โ–ฒ
              โ””โ”€โ”€โ”€โ”€โ”€โ”€ All synced in real-time โ”€โ”€โ”˜

๐Ÿ“‚ Project Structure

Findora/
โ”œโ”€โ”€ index.html          # Main portal โ€” hero, listings, filters, report modal
โ”œโ”€โ”€ admin.html          # Admin dashboard โ€” login, overview, item management
โ”œโ”€โ”€ style.css           # Core design system โ€” 21KB of hand-crafted CSS
โ”œโ”€โ”€ admin.css           # Admin-specific styles โ€” sidebar, tables, charts
โ”œโ”€โ”€ app.js              # Main app logic โ€” CRUD, search, filters, real-time
โ”œโ”€โ”€ admin.js            # Admin logic โ€” auth, tables, bulk actions, stats
โ”œโ”€โ”€ supabase-config.js  # Supabase client initialization (3 lines!)
โ”œโ”€โ”€ setup.sql           # Database schema, RLS policies, storage & seed data
โ””โ”€โ”€ README.md

โšก Quick Start

1. Clone & Configure

git clone https://github.com/siddiqui7864/Findora.git
cd Findora

2. Set Up Supabase (5 minutes)

  1. Create a free project at supabase.com
  2. Open SQL Editor โ†’ paste the contents of setup.sql โ†’ Run
  3. Copy your project URL and anon key from Settings โ†’ API

3. Add Credentials

// supabase-config.js
const SUPABASE_URL = "https://your-project.supabase.co";
const SUPABASE_ANON_KEY = "your-anon-key-here";

4. Launch

Open index.html in a browser. Done. No npm install, no build step, no server.

๐Ÿ’ก For development, use Live Server in VS Code.


๐Ÿ” Admin Access

Navigate to admin.html or click the Admin link in the navbar.

What admins can do:

  • ๐Ÿ“Š View real-time overview stats (total, lost, found, claimed)
  • ๐Ÿ“‹ See the 5 most recent reports at a glance
  • ๐Ÿ“ˆ Category breakdown with visual bar charts
  • ๐Ÿ”Ž Search and filter across all items
  • โœ… Mark items as claimed with one click
  • ๐Ÿ—‘๏ธ Delete individual items or bulk-select and remove
  • ๐Ÿงน Clear all claimed/resolved entries at once

๐ŸŽจ Design Philosophy

We didn't just build a functional tool โ€” we built something students would actually want to use.

Design Choice Implementation
Dark Theme Rich #0a0a0f background with layered surfaces
Glassmorphism backdrop-filter: blur() on cards, modals, navbar
Gradient Accents Purple โ†’ Cyan (#7c5cff โ†’ #00e5a0) throughout
Micro-Animations Scroll-triggered reveals, hover transforms, counter animations
Responsive Grid CSS Grid with adaptive breakpoints for all screen sizes
Custom Components Hand-built search bars, filter chips, toast system, modal dialogs

๐Ÿงฉ Challenges We Faced

Challenge How We Solved It
Real-time sync across devices Migrated from localStorage to Supabase with Postgres Changes subscription
Image storage without a backend Used Supabase Storage with public bucket and CDN-backed URLs
Keeping it zero-config No frameworks, no bundlers โ€” just <script> tags and the Supabase CDN client
Admin security without auth Session-based admin login with password gate (suitable for campus deployment)
Search performance Client-side filtering with debounced input for instant results

๐Ÿ”ฎ What's Next

If we had more time, here's what we'd build:

  • ๐Ÿ”‘ Supabase Auth โ€” Email/Google sign-in for verified submissions
  • ๐Ÿ“ง Email Notifications โ€” Alert users when a matching item is found
  • ๐Ÿ—บ๏ธ Campus Map Integration โ€” Pin locations on an interactive map
  • ๐Ÿค– AI Matching โ€” Auto-suggest potential matches between lost and found items
  • ๐Ÿ“Š Analytics Dashboard โ€” Trends, peak loss times, hotspot locations
  • ๐ŸŒ PWA Support โ€” Install as a native app on mobile devices

๐Ÿ‘ฅ Team

Name Role
Kunal Dubey Developer
Anjali Kumari Developer
Ambika Bains Developer
Abu Shad Siddiqui Developer

๐Ÿ“œ License

This project is open source under the MIT License.


โญ If you liked Findora, drop a star โ€” it means a lot!

Built with โค๏ธ at Hackathon 2026

About

๐Ÿ” A campus lost & found web portal โ€” report, browse, and claim lost items with filters, search, and an admin dashboard. Built with vanilla HTML, CSS & JS.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors