Lost & Found Community App 🔍

Production-Ready Lost & Found Ecosystem for Sri Lanka & Global Markets

⚠️ This is a FREE, open-source project. You can fork, customize, and deploy it for FREE using Firebase Spark Plan.

🎯 Problem Statement

Critical Pain Points:

15,000+ items lost daily in Sri Lanka (NICs, wallets, phones, documents)
No centralized trusted recovery system
Social media posts are unstructured, unsafe, and ineffective
Police manual processes take weeks
High risk of scams and fake claims
Language barriers (Sinhala, Tamil, English)

🚀 Quick Start (5 Minutes)

Prerequisites

Flutter SDK (3.38.5+)
Git
Google Account (for Firebase - FREE)

Installation

# Clone the repository
git clone https://github.com/pirinthaban/FindBack.git
cd FindBack

# Install dependencies
flutter pub get

# Run on web (no Firebase needed for demo)
flutter run -d chrome

# Or run on Android emulator
flutter run

Set Up Firebase (Required for Production)

Create FREE Firebase project: FIREBASE_SETUP.md
Copy environment variables:
```
cp .env.example .env
```
Add your Firebase keys to .env
Generate firebase_options.dart:
```
flutterfire configure
```

📖 Full setup guide: FIREBASE_SETUP.md

💡 Solution Overview

A location-based, trust-driven, AI-powered Lost & Found ecosystem that connects:

Citizens (item losers & finders)
Police departments (verification authority)
Universities (campus recovery hubs)
Transport hubs (airports, bus stands, train stations)

Key Differentiators:

AI-powered automatic matching between lost and found items
Offline-first architecture (works without internet)
Government NIC/Passport secure recovery flow
Community trust & reputation system
Multi-language support (Si/Ta/En)

🚀 Core Features

User Management

Phone + Email registration with OTP
Social login (Google, Facebook)
User profiles with reputation scores
Role-based access (Citizen, Police, University Admin)

Item Management

Post Lost items (with urgency levels)
Post Found items (with current location)
Multiple image upload (up to 5 per item)
AI auto-blur sensitive details (NIC numbers, faces)
Item categories: NIC, Passport, Phone, Wallet, Bag, Keys, Documents, Other
Location tagging with Google Maps
Radius-based nearby item discovery (500m - 50km)

Matching & Discovery

AI-powered Lost ↔ Found auto-matching
Image similarity detection (TensorFlow Lite)
Text description NLP matching
Location proximity scoring
Match confidence score (0-100%)
Smart push notifications for high-confidence matches

Communication & Claims

In-app encrypted chat
Claim ownership workflow with verification
Ownership proof submission (IMEI, photos, security questions)
Police verification mode
Report & block abusive users
Case closure & recovery confirmation

Trust & Safety

User reputation system (0-1000 points)
Community ratings & reviews
Anti-fraud detection algorithms
Audit logs for all critical actions
Privacy controls for sensitive documents
Rate limiting & spam prevention

🔬 Advanced & Unique Features

AI & Machine Learning

Image Matching Engine: Detects similar items using neural networks
Auto-categorization: Identifies item type from photos
Sensitive Data Blurring: Auto-detects and blurs NIC numbers, faces
NLP Matching: Analyzes descriptions for semantic similarity
Fraud Detection: Identifies suspicious patterns

Offline & Emergency

Offline-first Architecture: Post items without internet, sync later
Bluetooth Nearby Broadcast: Found phones broadcast to nearby devices
Emergency/Disaster Mode: Special UI for natural disasters
SMS Fallback: Critical notifications via SMS when offline

Integration Ready

QR Code Generation: Every item gets a unique QR code
NFC Tag Support: Future integration with physical tags
Police API Integration: Direct case filing
University Systems: Campus lost & found integration

Localization

Multi-language support (Sinhala, Tamil, English)
District-wise categorization (25 districts of Sri Lanka)
Local time & date formats

🛠️ Tech Stack

Frontend (Mobile App)

Framework: Flutter 3.16+
State Management: Riverpod 2.0
Architecture: Clean Architecture + MVVM
UI Library: Material Design 3
Navigation: go_router
Local Database: Hive + drift

Key Packages:

google_maps_flutter - Location services
image_picker - Camera & gallery
firebase_auth - Authentication
cloud_firestore - Real-time database
firebase_messaging - Push notifications
flutter_riverpod - State management
cached_network_image - Image caching
geolocator - GPS services
connectivity_plus - Network detection
hive - Offline storage
tflite_flutter - AI inference

Backend

Platform: Firebase
Authentication: Firebase Auth
Database: Firestore
Storage: Firebase Storage + Cloudinary
Functions: Cloud Functions (Node.js/TypeScript)
Hosting: Firebase Hosting (Admin Panel)
Analytics: Firebase Analytics
Crashlytics: Firebase Crashlytics

AI/ML

Image Matching: TensorFlow Lite (MobileNetV3)
NLP: Firebase ML + Cloud Natural Language API
Image Processing: Cloudinary AI
OCR: ML Kit Text Recognition
Face Detection: ML Kit Face Detection

DevOps & Tools

CI/CD: GitHub Actions
Version Control: Git
Code Quality: Flutter Analyzer, ESLint
Testing: flutter_test, mockito
Monitoring: Firebase Performance Monitoring
Error Tracking: Sentry

📊 System Architecture

┌─────────────────────────────────────────────────────────────┐
│                     MOBILE APP (Flutter)                     │
├─────────────────────────────────────────────────────────────┤
│  Presentation Layer (UI Screens)                            │
│  │                                                            │
│  ├─ Splash & Onboarding                                     │
│  ├─ Authentication Screens                                  │
│  ├─ Home Feed (Nearby Items)                                │
│  ├─ Post Lost/Found Flow                                    │
│  ├─ Item Details & Matching                                 │
│  ├─ Claims & Verification                                   │
│  ├─ Encrypted Chat                                          │
│  └─ Profile & Reputation                                    │
├─────────────────────────────────────────────────────────────┤
│  Application Layer (Business Logic)                         │
│  │                                                            │
│  ├─ State Management (Riverpod)                             │
│  ├─ Use Cases / Interactors                                 │
│  └─ View Models                                             │
├─────────────────────────────────────────────────────────────┤
│  Domain Layer (Core Business)                               │
│  │                                                            │
│  ├─ Entities (User, Item, Claim, Chat)                      │
│  ├─ Repositories (Interfaces)                               │
│  └─ Business Rules                                          │
├─────────────────────────────────────────────────────────────┤
│  Data Layer (External Services)                             │
│  │                                                            │
│  ├─ Firebase Repository Implementation                      │
│  ├─ Local Database (Hive)                                   │
│  ├─ AI Service (TFLite)                                     │
│  └─ Image Service (Cloudinary)                              │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                   FIREBASE BACKEND                           │
├─────────────────────────────────────────────────────────────┤
│  Authentication                                              │
│  │                                                            │
│  ├─ Phone Auth (OTP)                                        │
│  ├─ Email/Password                                          │
│  └─ OAuth (Google, Facebook)                                │
├─────────────────────────────────────────────────────────────┤
│  Firestore Database                                          │
│  │                                                            │
│  ├─ users/                                                  │
│  ├─ items/                                                  │
│  ├─ matches/                                                │
│  ├─ claims/                                                 │
│  ├─ chats/                                                  │
│  ├─ messages/                                               │
│  ├─ reports/                                                │
│  ├─ police_verifications/                                   │
│  └─ audit_logs/                                             │
├─────────────────────────────────────────────────────────────┤
│  Cloud Functions (Triggers & APIs)                          │
│  │                                                            │
│  ├─ onItemCreated() - AI matching trigger                   │
│  ├─ processImageUpload() - Blur sensitive data              │
│  ├─ calculateMatchScore() - AI matching algorithm           │
│  ├─ sendMatchNotification() - Push notifications            │
│  ├─ verifyClaim() - Ownership verification                  │
│  ├─ moderateContent() - Auto moderation                     │
│  └─ generateReports() - Analytics                           │
├─────────────────────────────────────────────────────────────┤
│  Firebase Storage                                            │
│  │                                                            │
│  ├─ item_images/                                            │
│  ├─ proof_documents/                                        │
│  └─ user_avatars/                                           │
├─────────────────────────────────────────────────────────────┤
│  Firebase Cloud Messaging                                    │
│  │                                                            │
│  ├─ Match Notifications                                     │
│  ├─ Claim Updates                                           │
│  └─ Chat Messages                                           │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│                  EXTERNAL SERVICES                           │
├─────────────────────────────────────────────────────────────┤
│  ├─ Cloudinary (Image Processing & CDN)                     │
│  ├─ Google Maps API (Geocoding & Maps)                      │
│  ├─ Twilio (SMS Notifications)                              │
│  └─ SendGrid (Email Notifications)                          │
└─────────────────────────────────────────────────────────────┘

🗄️ Database Design

Firestore Collections Structure

firestore/
├── users/
│   └── {userId}
│       ├── email: string
│       ├── phone: string
│       ├── displayName: string
│       ├── photoURL: string
│       ├── role: enum (citizen, police, university_admin, admin)
│       ├── reputation: number (0-1000)
│       ├── itemsPosted: number
│       ├── itemsReturned: number
│       ├── successRate: number (%)
│       ├── location: geopoint
│       ├── district: string
│       ├── verifiedPolice: boolean
│       ├── createdAt: timestamp
│       ├── lastActive: timestamp
│       └── fcmToken: string
│
├── items/
│   └── {itemId}
│       ├── type: enum (lost, found)
│       ├── category: enum (nic, passport, phone, wallet, bag, keys, documents, other)
│       ├── title: string
│       ├── description: string
│       ├── images: array<string> (URLs)
│       ├── blurredImages: array<string>
│       ├── location: geopoint
│       ├── locationName: string
│       ├── district: string
│       ├── radius: number (meters)
│       ├── geohash: string
│       ├── userId: string (ref)
│       ├── userName: string
│       ├── userPhone: string (encrypted)
│       ├── status: enum (active, claimed, verified, closed, expired)
│       ├── urgency: enum (low, medium, high, emergency)
│       ├── matchCount: number
│       ├── viewCount: number
│       ├── reportCount: number
│       ├── features: object (AI extracted features)
│       ├── embedding: array<number> (image embedding)
│       ├── createdAt: timestamp
│       ├── updatedAt: timestamp
│       └── expiresAt: timestamp
│
├── matches/
│   └── {matchId}
│       ├── lostItemId: string (ref)
│       ├── foundItemId: string (ref)
│       ├── confidenceScore: number (0-100)
│       ├── imageSimilarity: number
│       ├── textSimilarity: number
│       ├── locationProximity: number
│       ├── timeDifference: number (hours)
│       ├── matchedBy: enum (ai, manual)
│       ├── status: enum (pending, viewed, claimed, dismissed)
│       ├── createdAt: timestamp
│       └── notificationSent: boolean
│
├── claims/
│   └── {claimId}
│       ├── itemId: string (ref)
│       ├── claimantUserId: string (ref)
│       ├── itemOwnerId: string (ref)
│       ├── status: enum (pending, under_review, verified, rejected, completed)
│       ├── proofDocuments: array<string> (URLs)
│       ├── proofAnswers: object
│       ├── verificationQuestions: array<object>
│       ├── verifiedBy: string (userId - police/admin)
│       ├── verificationNotes: string
│       ├── meetupLocation: geopoint
│       ├── meetupTime: timestamp
│       ├── handoverConfirmed: boolean
│       ├── handoverCode: string (6-digit)
│       ├── createdAt: timestamp
│       └── completedAt: timestamp
│
├── chats/
│   └── {chatId}
│       ├── itemId: string (ref)
│       ├── participants: array<string> (userIds)
│       ├── participantNames: object
│       ├── lastMessage: string
│       ├── lastMessageTime: timestamp
│       ├── unreadCount: object {userId: count}
│       ├── createdAt: timestamp
│       └── archived: boolean
│
├── messages/
│   └── {messageId}
│       ├── chatId: string (ref)
│       ├── senderId: string (ref)
│       ├── text: string (encrypted)
│       ├── type: enum (text, image, location, system)
│       ├── mediaUrl: string
│       ├── readBy: array<string> (userIds)
│       ├── createdAt: timestamp
│       └── deleted: boolean
│
├── reports/
│   └── {reportId}
│       ├── reporterUserId: string (ref)
│       ├── reportedUserId: string (ref)
│       ├── itemId: string (ref)
│       ├── reason: enum (spam, fraud, inappropriate, fake)
│       ├── description: string
│       ├── evidence: array<string> (URLs)
│       ├── status: enum (pending, investigating, resolved, dismissed)
│       ├── reviewedBy: string (admin userId)
│       ├── actionTaken: string
│       ├── createdAt: timestamp
│       └── resolvedAt: timestamp
│
├── police_verifications/
│   └── {verificationId}
│       ├── itemId: string (ref)
│       ├── claimId: string (ref)
│       ├── officerId: string (ref)
│       ├── stationName: string
│       ├── caseNumber: string
│       ├── verificationStatus: enum (pending, verified, rejected)
│       ├── officerNotes: string
│       ├── documents: array<string>
│       ├── createdAt: timestamp
│       └── verifiedAt: timestamp
│
├── notifications/
│   └── {notificationId}
│       ├── userId: string (ref)
│       ├── type: enum (match, claim, message, system)
│       ├── title: string
│       ├── body: string
│       ├── data: object
│       ├── read: boolean
│       ├── actionUrl: string
│       └── createdAt: timestamp
│
└── audit_logs/
    └── {logId}
        ├── userId: string (ref)
        ├── action: string
        ├── entityType: string
        ├── entityId: string
        ├── changes: object
        ├── ipAddress: string
        ├── deviceInfo: object
        └── timestamp: timestamp

Indexing Strategy

Composite Indexes (Firestore):

# Items collection
- collection: items
  fields:
    - status: ASC
    - geohash: ASC
    - createdAt: DESC

- collection: items
  fields:
    - type: ASC
    - category: ASC
    - status: ASC
    - createdAt: DESC

- collection: items
  fields:
    - userId: ASC
    - status: ASC
    - createdAt: DESC

# Matches collection
- collection: matches
  fields:
    - lostItemId: ASC
    - confidenceScore: DESC
    - status: ASC

- collection: matches
  fields:
    - foundItemId: ASC
    - confidenceScore: DESC
    - status: ASC

# Claims collection
- collection: claims
  fields:
    - itemId: ASC
    - status: ASC
    - createdAt: DESC

# Messages collection
- collection: messages
  fields:
    - chatId: ASC
    - createdAt: ASC

🔐 Security & Trust

Authentication & Authorization

Multi-factor Authentication:
  - Phone OTP (Primary)
  - Email verification (Secondary)
  - Biometric (Face ID / Fingerprint)

Role-Based Access Control:
  - Citizen: Post, claim, chat
  - Police: Verify, investigate
  - University Admin: Manage campus items
  - Super Admin: Full access, moderation

Session Management:
  - JWT tokens with 30-day expiry
  - Auto-refresh tokens
  - Device tracking
  - Force logout on suspicious activity

Data Protection

Encryption:
  - End-to-end chat encryption (AES-256)
  - PII encryption at rest
  - Phone numbers hashed
  - Sensitive documents encrypted

Privacy Controls:
  - Auto-blur NIC numbers
  - Face detection and blur
  - Location fuzzing (show area, not exact point)
  - Phone number masking (94XX XXX XX12)

Anti-Fraud Mechanisms

Rate Limiting:
  - Max 5 items per user per day
  - Max 3 claims per item
  - Max 50 messages per hour

Fraud Detection:
  - Duplicate item detection
  - Suspicious pattern analysis
  - IP tracking
  - Device fingerprinting
  - Velocity checks

Trust Scoring:
  - Reputation points (0-1000)
  - Success rate tracking
  - Community ratings
  - Time-based trust building

Firebase Security Rules

See: firestore.rules and storage.rules

🎨 UI/UX Design

Screen Flow

[Splash Screen]
    ↓
[Onboarding] → (First time users)
    ↓
[Phone Verification]
    ↓
[OTP Entry]
    ↓
[Profile Setup]
    ↓
[Home Feed]
    ├─ [Post Lost Item]
    │   ├─ Select Category
    │   ├─ Add Photos
    │   ├─ Add Description
    │   ├─ Set Location
    │   └─ Submit
    │
    ├─ [Post Found Item]
    │   ├─ Select Category
    │   ├─ Add Photos
    │   ├─ Add Description
    │   ├─ Set Location
    │   └─ Submit
    │
    ├─ [Item Details]
    │   ├─ View Images
    │   ├─ View Matches (AI suggested)
    │   ├─ Contact Owner (Chat)
    │   └─ Claim Item
    │
    ├─ [Claim Flow]
    │   ├─ Submit Proof
    │   ├─ Answer Questions
    │   ├─ Wait Verification
    │   └─ Arrange Meetup
    │
    ├─ [Chat Screen]
    │   ├─ Send Messages
    │   ├─ Share Location
    │   └─ Report User
    │
    ├─ [Profile]
    │   ├─ My Items
    │   ├─ My Claims
    │   ├─ Reputation Score
    │   ├─ Settings
    │   └─ Logout
    │
    └─ [Police Dashboard]
        ├─ Verification Queue
        ├─ Active Cases
        └─ Reports

Design System

Color Palette:

Primary: #1976D2 (Blue - Trust)
Secondary: #FF6B35 (Orange - Found)
Accent: #4CAF50 (Green - Success)
Warning: #FFA726 (Orange - Lost)
Error: #EF5350 (Red - Danger)
Background: #F5F5F5
Surface: #FFFFFF
Text Primary: #212121
Text Secondary: #757575

Typography:

Font Family: Poppins (Primary), Noto Sans Sinhala, Noto Sans Tamil
Heading 1: 24px, Bold
Heading 2: 20px, SemiBold
Body: 16px, Regular
Caption: 14px, Regular
Button: 16px, Medium

Components:

Bottom Navigation (Home, Search, Post, Chats, Profile)
Floating Action Button (Quick Post)
Item Cards (Grid/List view)
Match Confidence Badge
Reputation Stars
Category Chips
Map View with Clusters

💰 Monetization Strategy

Revenue Streams

1. Freemium Model

Free Tier:
  - Post 3 items per month
  - Basic AI matching
  - Standard notifications
  - 24-hour support

Premium ($2.99/month):
  - Unlimited item posts
  - Priority AI matching
  - Instant notifications
  - Featured listings
  - 24/7 priority support
  - Advanced analytics

2. Institutional Subscriptions

Universities ($99/month):
  - Campus-wide lost & found system
  - Custom branding
  - Admin dashboard
  - Student verification integration
  - Analytics & reports

Transport Hubs ($199/month):
  - Airport/bus stand integration
  - Staff accounts
  - Digital lost property office
  - Monthly reports

Police Departments (Free):
  - Verification tools
  - Case management
  - Public service partnership

3. Sponsored Services

Insurance Partnerships:
  - Promoted recovery services
  - Quick claim processing
  - Insurance claim integration

Recovery Agents:
  - Professional recovery services
  - Verified agent listings
  - Commission-based model

4. Advertising (Non-intrusive)

Sponsored Items:
  - Lost pet recovery services
  - Document recovery agencies
  - Locksmiths, phone repair shops

5. Government Partnerships

NIC/Passport Recovery:
  - Official government integration
  - Streamlined replacement process
  - Verification services

Projected Revenue (Year 1)

Users: 50,000 (Sri Lanka)
Premium Conversion: 5% = 2,500 users
Premium Revenue: 2,500 × $2.99 × 12 = $89,700

Institutions: 20 universities + 10 transport hubs
Institutional Revenue: (20 × $99 + 10 × $199) × 12 = $47,640

Advertising: $500/month = $6,000

Total Year 1: ~$143,340

🚀 Deployment Guide

Prerequisites

flutter --version  # 3.16.0+
node --version     # 18.0.0+
firebase --version # 12.0.0+

Firebase Setup

1. Create Firebase Project

firebase login
firebase projects:create lost-found-lk
firebase use lost-found-lk

2. Enable Services

Authentication (Phone, Email, Google)
Firestore Database
Cloud Storage
Cloud Functions
Cloud Messaging
Analytics
Crashlytics

3. Add Firebase to Flutter

flutterfire configure

Cloudinary Setup

1. Create Account

Sign up at cloudinary.com
Get Cloud Name, API Key, API Secret

2. Configure Transformations

Auto-blur preset: ai_blur_sensitive
Image optimization: f_auto,q_auto
Responsive: w_auto,c_scale

Environment Configuration

Create .env files:

# .env
FIREBASE_PROJECT_ID=lost-found-lk
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
GOOGLE_MAPS_API_KEY=your_maps_key

Build & Release

Android:

flutter build apk --release
flutter build appbundle --release

iOS:

flutter build ios --release

Deployment Checklist

📈 Scalability Plan

Phase 1: Sri Lanka Launch (0-10K users)

Infrastructure:
  - Firebase Spark Plan (Free)
  - Single region (asia-south1)
  - Basic AI matching

Capacity:
  - 10K concurrent users
  - 50K items
  - 100K messages/day

Phase 2: National Scale (10K-100K users)

Infrastructure:
  - Firebase Blaze Plan (Pay-as-you-go)
  - CDN enabled (Cloudinary)
  - Advanced AI matching
  - Multi-language support

Capacity:
  - 100K concurrent users
  - 500K items
  - 1M messages/day
  - Auto-scaling cloud functions

Phase 3: Regional Expansion (100K-1M users)

Infrastructure:
  - Multi-region deployment
  - Microservices architecture
  - Dedicated AI inference servers
  - Redis caching layer
  - Elasticsearch for search

Capacity:
  - 1M concurrent users
  - 5M items
  - 10M messages/day
  - 99.9% uptime SLA

Performance Optimization

Database:
  - Query optimization with indexes
  - Data partitioning by district
  - Read replicas for heavy queries

Images:
  - Cloudinary CDN
  - WebP format
  - Lazy loading
  - Progressive image loading

Caching:
  - Client-side caching (Hive)
  - Server-side caching (Redis)
  - CDN caching
  - API response caching

🧪 Testing Strategy

Unit Tests

Coverage Target: 80%
Test Cases:
  - Business logic
  - Data models
  - Utilities
  - Validators

Integration Tests

Test Cases:
  - API integration
  - Database operations
  - Authentication flows
  - Image upload & processing

UI Tests

Test Cases:
  - Critical user flows
  - Form validation
  - Navigation
  - Error states

Performance Tests

Metrics:
  - App launch time < 2s
  - Screen load time < 1s
  - API response time < 500ms
  - Image load time < 1s

Security Tests

Test Cases:
  - Authentication bypass attempts
  - SQL injection (N/A - NoSQL)
  - XSS attacks
  - Rate limiting
  - Data encryption

📚 Project Structure

lost_and_finder/
├── android/                 # Android native code
├── ios/                     # iOS native code
├── lib/
│   ├── core/
│   │   ├── constants/
│   │   ├── theme/
│   │   ├── utils/
│   │   ├── error/
│   │   └── network/
│   ├── features/
│   │   ├── authentication/
│   │   │   ├── data/
│   │   │   ├── domain/
│   │   │   └── presentation/
│   │   ├── items/
│   │   │   ├── data/
│   │   │   ├── domain/
│   │   │   └── presentation/
│   │   ├── matching/
│   │   │   ├── data/
│   │   │   ├── domain/
│   │   │   └── presentation/
│   │   ├── claims/
│   │   ├── chat/
│   │   ├── profile/
│   │   └── police/
│   └── main.dart
├── functions/               # Cloud Functions
│   ├── src/
│   │   ├── triggers/
│   │   ├── ai/
│   │   └── utils/
│   └── package.json
├── assets/
│   ├── images/
│   ├── fonts/
│   └── models/             # TFLite models
├── test/
├── firebase.json
├── firestore.rules
├── storage.rules
└── pubspec.yaml

🎓 Academic Project Components

Abstract

See: docs/ACADEMIC_ABSTRACT.md

Full Documentation

See: docs/ folder for:

System Requirements Specification (SRS)
Software Design Document (SDD)
Test Plan
User Manual
Technical Report

🌟 Future Enhancements

Phase 2 Features:

Video testimonials
Blockchain-based ownership proof
Augmented Reality item preview
Voice search
Real-time translation
Dark mode

Phase 3 Features:

International expansion
Multi-currency support
Shipping integration
Insurance claim integration
Reward system for finders
Community events

📝 License

MIT License - See LICENSE file

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

How to Contribute

Fork this repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit changes: git commit -m 'Add amazing feature'
Push to branch: git push origin feature/amazing-feature
Open a Pull Request

Areas We Need Help

🎨 UI/UX improvements
🌐 Sinhala/Tamil translations
🧪 Unit & integration tests
📚 Documentation
♿ Accessibility features
⚡ Performance optimization

👥 Contributors

This is an open-source community project.

Original Author: pirinthaban
Project Type: Final Year Project / Community Initiative
University: [Your University] (Optional)

Want to be listed here? Contribute!

📞 Support & Community

🐛 Bug Reports: Open an issue
💡 Feature Requests: Open an issue
💬 Discussions: GitHub Discussions
📧 Email: [email protected] (optional)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

TL;DR: You can freely use, modify, and distribute this project for personal or commercial use.

🙏 Acknowledgments

Flutter & Firebase communities
Open-source contributors
Sri Lanka Police (inspiration)
Universities & transport hubs
Everyone who loses things 😄

⭐ Star This Project

If this project helped you, please give it a ⭐ on GitHub!

Made with ❤️ for Sri Lanka and the world

Name		Name	Last commit message	Last commit date
Latest commit History 30 Commits
.github		.github
android		android
assets/images		assets/images
docs-legal-pages		docs-legal-pages
docs		docs
findback-functions		findback-functions
findback-webapp		findback-webapp
findback-website		findback-website
functions		functions
lib		lib
test		test
web		web
windows		windows
.env.example		.env.example
.firebaserc		.firebaserc
.gitignore		.gitignore
.metadata		.metadata
AI_FEATURES_STATUS.md		AI_FEATURES_STATUS.md
AI_QUICK_REFERENCE.md		AI_QUICK_REFERENCE.md
AI_VISUAL_GUIDE.md		AI_VISUAL_GUIDE.md
CHANGELOG.md		CHANGELOG.md
CLOUDINARY_SETUP.md		CLOUDINARY_SETUP.md
CONTRIBUTING.md		CONTRIBUTING.md
CRITICAL_AI_STATUS.md		CRITICAL_AI_STATUS.md
FACE_RECOGNITION_FEATURE.md		FACE_RECOGNITION_FEATURE.md
FIREBASE_SETUP.md		FIREBASE_SETUP.md
FREE_AI_SETUP.md		FREE_AI_SETUP.md
GITHUB_PAGES_PUBLISH.md		GITHUB_PAGES_PUBLISH.md
GITHUB_PUBLISH.md		GITHUB_PUBLISH.md
GOOGLE_SIGNIN_SETUP.md		GOOGLE_SIGNIN_SETUP.md
LICENSE		LICENSE
PRIVACY_POLICY.md		PRIVACY_POLICY.md
PRIVACY_SECURITY_GUIDE.md		PRIVACY_SECURITY_GUIDE.md
PUBLISH_CHECKLIST.md		PUBLISH_CHECKLIST.md
PUBLISH_NOW.md		PUBLISH_NOW.md
QUICK_PUBLISH.md		QUICK_PUBLISH.md
README.md		README.md
READY_TO_PUBLISH.md		READY_TO_PUBLISH.md
RELEASE_NOTES.md		RELEASE_NOTES.md
RELEASE_v1.0.3.md		RELEASE_v1.0.3.md
RELEASE_v1.0.4.md		RELEASE_v1.0.4.md
RUNNING_THE_APP.md		RUNNING_THE_APP.md
SECURITY.md		SECURITY.md
SETUP.md		SETUP.md
START_HERE.md		START_HERE.md
TERMS_AND_CONDITIONS.md		TERMS_AND_CONDITIONS.md
UI_UPGRADE_SUMMARY.md		UI_UPGRADE_SUMMARY.md
UPDATE_SYSTEM_GUIDE.md		UPDATE_SYSTEM_GUIDE.md
analysis_options.yaml		analysis_options.yaml
analysis_output.txt		analysis_output.txt
bugreport-sdk_gphone64_x86_64-BP41.250916.009.A1-2025-12-16-15-56-11.zip		bugreport-sdk_gphone64_x86_64-BP41.250916.009.A1-2025-12-16-15-56-11.zip
build_error_fix.txt		build_error_fix.txt
build_error_log.txt		build_error_log.txt
build_error_ocr.txt		build_error_ocr.txt
build_fail_log.txt		build_fail_log.txt
build_log.txt		build_log.txt
build_log_2.txt		build_log_2.txt
build_output.txt		build_output.txt
build_output_utf8.txt		build_output_utf8.txt
deploy_output.txt		deploy_output.txt
firebase.json		firebase.json
firestore.indexes.json		firestore.indexes.json
firestore.rules		firestore.rules
pubspec.lock		pubspec.lock
pubspec.yaml		pubspec.yaml
safety-check.ps1		safety-check.ps1
storage.rules		storage.rules
version.json		version.json

License

pirinthaban/findback

Folders and files

Latest commit

History

Repository files navigation

Lost & Found Community App 🔍

Production-Ready Lost & Found Ecosystem for Sri Lanka & Global Markets

🎯 Problem Statement

🚀 Quick Start (5 Minutes)

Prerequisites

Installation

Set Up Firebase (Required for Production)

💡 Solution Overview

🚀 Core Features

User Management

Item Management

Matching & Discovery

Communication & Claims

Trust & Safety

🔬 Advanced & Unique Features

AI & Machine Learning

Offline & Emergency

Integration Ready

Localization

🛠️ Tech Stack

Frontend (Mobile App)

Backend

AI/ML

DevOps & Tools

📊 System Architecture

🗄️ Database Design

Firestore Collections Structure

Indexing Strategy

🔐 Security & Trust

Authentication & Authorization

Data Protection

Anti-Fraud Mechanisms

Firebase Security Rules

🎨 UI/UX Design

Screen Flow

Design System

💰 Monetization Strategy

Revenue Streams

Projected Revenue (Year 1)

🚀 Deployment Guide

Prerequisites

Firebase Setup

Cloudinary Setup

Environment Configuration

Build & Release

Deployment Checklist

📈 Scalability Plan

Phase 1: Sri Lanka Launch (0-10K users)

Phase 2: National Scale (10K-100K users)

Phase 3: Regional Expansion (100K-1M users)

Performance Optimization

🧪 Testing Strategy

Unit Tests

Integration Tests

UI Tests

Performance Tests

Security Tests

📚 Project Structure

🎓 Academic Project Components

Abstract

Full Documentation

🌟 Future Enhancements

📝 License

🤝 Contributing

How to Contribute

Areas We Need Help

👥 Contributors

📞 Support & Community

📄 License

🙏 Acknowledgments

⭐ Star This Project

📊 Project Stats

About

Topics

Packages