Skip to content

pratham-developer/FindIT

 
 

Repository files navigation

FindIt Logo

FindIT: Lost & Found App for VIT

Find what's lost, return what's found — fast, secure and student-only.

FindIt App Screenshots

🌟 Overview

FindIt is a campus-exclusive platform built for VIT students to report, search, and claim lost items. With integrated image moderation, QR-based secure claims and a clean mobile interface — it ensures trust, security, and ease of use for the entire student community.

🎒 For Users

  • Post lost/found items with images
  • Advanced search with filters
  • Claim items via QR verification
  • Track all your posts and claims
  • Image moderation to prevent abuse

🔐 For Admins

  • Manage and moderate content
  • Delete unsafe/inappropriate posts
  • Track app versioning
  • Admin-only secure endpoints

✨ Key Features

🧭 Lost & Found Flow

  1. Report - Upload images, select category (lost/found), and describe the item
  2. Moderate - AI-based image moderation prevents NSFW/abusive content
  3. Search - Use filters or keywords to browse through reported items
  4. Claim - Found your item? Request claim using the secure QR flow
  5. Verify - Show your QR to the finder and verify ownership
  6. Complete - Item handed over, claim closed securely!

⚠️ Note: All interactions are verified with VIT Google login. No outsiders allowed.

🛡️ Security Features

🔐

VIT-Only Access
Sign in with official college email via Firebase

🖼️

AI Image Moderation
NSFW detection via TensorFlow.js + NSFWJS

🔄

Secure QR Claims
Time-bound, JWT-authenticated QR codes

🛠️

Admin Controls
Manual moderation & unsafe post removal

🛠️ Tech Stack


Kotlin

Node.js

MongoDB

Firebase

Cloudinary

TensorFlow.js

📱 Application Architecture

System Architecture

┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
│                 │      │                 │      │                 │
│   User Mobile   │◄────►│    FindIT API   │◄────►│   NSFW Check    │
│   Application   │      │    (Backend)    │      │                 │
│                 │      │                 │      └─────────────────┘
└─────────────────┘      └────────┬────────┘      
                                  │
                                  ▼
                         ┌─────────────────┐
                         │                 │
                         │    MongoDB      │
                         │    Database     │
                         │                 │
                         └─────────────────┘

Mobile Architecture


FindIT/
├── Authentication
│   └── Google Sign-In (VIT only)
├── Item Feed
│   └── Search Lost Item
│       └── Claim Lost Item
│           └── QR Code Scanner
│               └── Secure Claiming
├── Post Item
│   └── Upload Details + Image (Report Found Item)
│       └── Item Reported Successfully
└── My Profile
    ├── My Activity
    │   ├── My Claims (Claimed Item Details)
    │   └── My Reports (All Reported Items)
    │       └── List of Items Reported & Claimed
    │       └── Generate QR (For Secure Claiming)
    │       └── Delete Item
    ├── Terms & Conditions
    ├── Contact Us
    ├── Developer Team
    └── Sign Out



⚙️ Implementation Status

Component Status Notes
User Authentication ✅ Complete Google OAuth via Firebase (VIT Email only)
Image Upload & Moderation ✅ Complete Cloudinary + NSFWJS
Lost/Found Posting ✅ Complete Fully functional with filters
QR Claim Flow ✅ Complete JWT-secured, time-limited QR claims
My Items & Claims Page ✅ Complete Users can manage their history
Admin Tools ✅ Complete Moderation & delete functionality
App Core Features ✅ Complete Working version deployed, UI refinements ongoing

🚀 Getting Started

📲 Download the App

You can download the FindIT app directly from our official website:
🌐 www.finditapp.me

Or, download the APK from our Initial Release GitHub release.

🔒 VIT Google Sign-In is required to access the app.


🔗 Related Repositories

👥 Meet Our Team

Rudra Gupta

App & Website Developer

Pratham Khanduja

App & Backend Developer


About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Kotlin 100.0%