Skip to content

NW3N4R/lostandfound

Repository files navigation

🔍 Lost & Found

A production-ready, cross-platform Lost & Found community app built with Flutter & Dart. Users can post lost or found items through a real-time social feed, upload images, contact others directly, and manage their profiles — all backed by a robust offline-first SQLite engine.


💡 Why Lost & Found?

Every day, people lose things that matter to them — and others find items with no way to return them. This app bridges that gap by giving communities a dedicated, simple platform to post, search, and reconnect lost items with their owners.


✨ Features

  • 📸 Image posting — Upload photos of lost or found items via image_picker
  • 📰 Dynamic social feed — Browse real-time community posts with smooth animations
  • 📞 Direct calling — Call item reporters directly from the app via flutter_phone_direct_caller
  • 🔗 URL launching — Open external links and contacts with url_launcher
  • 🗄️ Offline-first database — All data stored locally with SQLite for fast, reliable access
  • 🌍 Multi-language support — Full localization with flutter_localization
  • 🎨 Light & Dark mode — Beautiful SVG backgrounds for both themes
  • 🔔 Toast notifications — Clean in-app feedback via toastification
  • 👤 Account & profile management — Secure session handling with shared_preferences
  • 🖥️ All platforms — Android, iOS, Windows, macOS, Linux, and Web

🛠️ Tech Stack

Package Purpose
sqflite Local SQLite database
image_picker Camera & gallery image uploads
provider State management
flutter_localizations + flutter_localization Multi-language support
flutter_svg SVG rendering for backgrounds
flutter_phone_direct_caller One-tap direct calling
url_launcher External link handling
animate_gradient Gradient animations
flutter_animated_button Animated UI interactions
toastification In-app toast messages
multi_dropdown Multi-select filter dropdowns
shared_preferences Persistent user settings
package_info_plus App version info

🚀 Getting Started

Prerequisites

  • Flutter SDK (^3.10.4)
  • Android Studio or VS Code with Flutter extension

Installation

  1. Clone the repository:
   git clone https://github.com/NW3N4R/lostandfound.git
   cd lostandfound
  1. Install dependencies:
   flutter pub get
  1. Run the app:
   flutter run

🗂️ Project Structure

lostandfound/

├── lib/ # Main Dart source code

├── assets/

│ ├── fonts/ # Roboto, OpenSans, Inter

│ ├── bg_light.svg # Light mode background

│ ├── bg_dark.svg # Dark mode background

│ └── logo.png # App icon

├── android/

├── ios/

├── windows/

├── macos/

├── linux/

└── web/


🌍 Platforms Supported

Platform Status
Android
iOS
Windows
macOS
Linux
Web

🤝 Contributing

Contributions are welcome — this project has real community impact!

  • Open an Issue for bugs or feature ideas
  • Submit a Pull Request with improvements
  • Star ⭐ the repo to show support

📬 Contact

Built by @NW3N4R — open to connecting and collaborating!


📄 License

Open source — add your preferred license.

About

A real-time cross-platform Lost & Found utility built with Flutter & Dart. Features dynamic social feeds, image posting, secure account management, and profile customization. Engineered with SQLite for optimized relational queries, local data indexing, and fluid offline persistence. Minimalist, production-ready, and high-performance.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages