ruland39 / lostandfoundapp

A LostandFound Mobile Application

LostandFoundApp

A Lost and Found Item Management System Android Application

Description

LostAndFoundApp is an Android Application developed using Kotlin and Firebase. This project aims to solve the lost and found management system on campus. It is firstly designed using Figma to conform to all the app's functionalities. It relies on Material Design as the UI design system chosen and Firestore to handle all the data management. This project is accomplished within 1 month from scratch to deployment.

Figma

The Design file can be accessed here and the prototype here

Demo Video

LostandFoundAppDemo.mp4

Additional Info

• If the video is buffering all the time (which I assume is most likely), you can view it here instead
• This repository contains the entirety of LostandFoundApp's source code associated with the application.
• LostandFoundApp was built using Kotlin and the Android SDK. Compiled using Kotlin Compiler using JVM.

Installation

• Download the latest .apk instance from here or through the GitHub releases.
• Allow installation from third-party sources on your Android application
• Current release information: v1.0

User Documentation

1. Open the App

2. Go through the all the feature page

3. Choose Register

4. Fill in all details

5. Once successful, it will bring you to the home page

6. To Claim an Item:

   • Go to the item card you want to claim
   • Click the dropdown button to see details
   • You can click the image to expand the preview
   • Read all details to make sure it is yours
   • Proceed by clicking the Claim Item Button
   • It will bring you to a claim form, check all the personal details
   • If details are correct, continue by taking the picture on the collection site
   • If a claim is successful, it will bring you back to the home page where the button will say Item has been claimed now

7. To Report an Item

   • Go to the home page
   • Click on the + Floating action button
   • It will bring you to the report item page
   • Fill up all the item details (you can only proceed if all details are filled)
   • Submit the item report by clicking on the Submit button
   • If a report is successful, it will create the item card on the home page

8. Additionally, you can click on the menu button on the top right side of the home page > Help > to make Email and Phone Call for any further assistance

Credits

Google Material Design

Google Firebase

Glide Image Loader

Contribution

This repository contains the source code for LostandFoundApp, as a school project. Feel free to contribute further to the development by simply cloning this repository through Android Studio or your preferred IDE.