HooFoundIt

HooFoundIt is a centralized lost and found app for UVA students. It lets users post lost or found items with photos and locations, browse a campus map and list view, search and filter posts, and submit or manage claims so items can get back to their owners more reliably. The app focuses on making the current fragmented and confusing lost-and-found process at UVA simpler, clearer, and easier to use for students.

Team Members:

Shawn Malik - wbr4az Ivan Kisselev - wnc8zw Levi Dawit - kpn5ef

Builds:

We currently don't have our app hosted on TestFlight. To build our app, on a Mac, clone/download this repo, and run the iOS Simulator in XCode. We can also download this app on to an iPhone manually

Below is a demo video of our app: App_Demo.mp4

Installation Instructions:

1. Clone this repository
2. Open the XCode project
3. Install dependencies (running the Simulator should automatically do this)
4. Run the app:
   • Select an iOS Simulator (ex: iPhone 15)
   • Click the Run button in XCode

User Accounts:

HooFoundIt uses email-based magic-link authentication. To test the app, enter any email address you control and follow the magic link sent to that inbox to sign in.

To see the verified badge behavior, sign in with a @virginia.edu email. Non-@virginia.edu emails will appear as unverified users.

Usage Instructions

1. Sign In

   • Open the app and enter your email address.
   • Check your inbox for the magic link and tap it to complete sign-in.
   • @virginia.edu accounts will appear as verified users.

2. Browsing the Map

   • Use the Map tab to view pins for lost and found items around campus.
   • Tap a pin to view a short description and image preview.

3. Using the List View

   • Switch to the List tab to see all items in a scrollable list.
   • Verified posts are marked with a small badge to show trusted posters.

4. To View Item Details

   • Tap any post to open the item detail screen.
   • Review the description, location metadata, and any attached images.

5. To Submit a Claim

   • On the detail view of an item, tap Claim to request ownership.
   • Open the Claims section to track:
     • Outgoing claims: items you have claimed.
     • Incoming claims: other users claiming items you posted.

6. Create a Post (Manually)

   • Tap Post or New Item.
   • Enter the title, description, and location fields.
   • Upload images, reorder them if needed, and submit the post.

7. Create a Post (AI Assisted)

   • Start a new post
   • Upload an image and use AI Auto-Complete to automatically generate a title and description of the item.
   • Edit the suggestions if needed and then submit.

8. Filter and Search

   • On the Map, apply filters such as status, time, or location.
   • On the List, use the search bar to filter items by title or keywords.

9. Manage Your Posts

   • Open the My Posts section.
   • Tap Edit to change information or Delete to remove a post.

10. Log Out

    • Open Profile or Settings and tap Log Out to end your session.

Admin Accounts

Please see ADMIN_MANAGEMENT.md to see how to configure an admin account on our app. You will also need to access our project on Firebase to add an admin account. We have gone ahead and added the emails mentioned in the technical report assignment description to the project as editors. Please reach out if there are issues or if another email address is needed. Firebase Project: https://console.firebase.google.com/u/0/project/hoofoundit/overview

Sources Used:

• Apple Developer Documentation
• OpenAI ChatGPT (mainly for help with UI styling and debugging)
• Google Maps API Documentation
• Gemini API Documentation
• Stack Overflow