Contains team's GrindMinds submission for Lifelines hackathon at CMUQ in Spring 2025
git clone https://github.com/Mohamed-Waiel-Shikfa/LifelinesS25.git
cd LifelinesS25
pip install -r requirements.txt
reflex init
reflex run
reflex db init
reflex db makemigrations
reflex db migrateand open localhost on the port it chooses
Our platform is a digital space (website) for people missing and found people, pets and items. Users can post lost or found people/items with descriptions, images, and locations and each listing will create a community thread/channel. These public threads are hubs for information gathering, discussion, investigation, and collaboration where users contribute information, share tips, and work together to locate missing people or items.
The platform is designed to foster a strong sense of community whether public or private, with each thread optimized for gathering clues and facilitating real-time communication between members.
Innovative tools and features like geotagged locations, updates, interactive search maps, shared media repositories, checklists, task assignment, tracking, AI similarity lost & found search and archived success stories allow users to engage in the search process and increase the chances of recovery.
We are not just showcasing lost items, we are helping people connect and come together as a community to assist those in need.
- Lost & Found Listings
- Community Channels/Threads for each listing item (Public/Private)
- Geo-Location Integration
- Collaboration Tools
- Private Chats
- Archive
- Notification System
- Lost & Found Listings
- Users can post lost or found items with descriptions, photos, and locations.
- Map tagging of items by location
- Categorize listings
- Search engine & Filters
- AI systems for similarity search to match (Lost to founds)
- Community Channels/Threads for each listing (Public/Private)
- Each listing creates (is linked to) a thread for collaboration
- Features include geotagged updates, shared photos, and status flags (“last sighted”, “verified safe”).
- Users can upvote or tag useful clues to keep the thread focused.
- Geo-Location Integration
- Interactive map view of reported locations, and search zones (with items pinned on the coordinates).
- Alternative search view for lost/found in approximate map locations you select.
- Heatmaps to track areas of activity for missing items or people.
- Collaboration Tools
- Shared Media Repository:
- Checklists for tasks like calling shelters, checking lost & found offices, and volunteer gathering.
- Polls for collective decision-making
- Task Assignment and Tracking (Assign specific roles to community members, track task progress, and set deadlines for time-sensitive efforts)
- Private Chats
- Connect users with individuals responsible for found items or those reporting lost items for private verification and claims.
- Archive
- Success Stories: a section for archived items that were successfully found through the platform.
- User-submitted stories, how the community helped recover items.
- Case Studies: provide insights into complex recoveries as inspiration and guidance for users.
- Searchable History: browse, filter, and search.
- Notification System
- Notify users via Email when descriptions of lost items match newly found items or reports.
- Alerts for updates in thread sightings, relevant information, and verified leads.
- Community collaboration: dedicated thread or channels for each lost item where people share tips, and information in real-time
- Investigation tools: geotagged updates, interactive maps, image sharing.
- Enhanced communication: users can discuss and share advice, coordinate resources, and work together towards a shared purpose.
- Search-based community-driven network of people.
- Alternative search view (map view)
- Upvote/tagging system in community threads
- Task assignment and tracking
- Searchable history archive of lost & found items success stories
- AI systems for similarity search
- Heatmaps for activity tracking
- Notification system for matching items
We have achieved the following milestones in our project:
- Created a user and posts database to store:
- Username
- Title
- Description
- Creation time of listings
- Information about the people creating these listings
- Developed fully functional login and registration pages with authentication.
- Implemented fully functional features for adding, editing, and saving posts.
- Enabled viewing of all posts.
- Created a map page that shows example pins and data.
- Planned to create communities directly linked to posts, allowing everyone to join each community and use tools to help find lost persons, pets, or items.
- Drafted a private chat interface showcasing chat with AI integration (currently not fully functional).
- Ensured the platform is mobile responsive.
You can check the 4-minute demo of the current functionality at the following URL: Watch the demo
From MVP through Final we added following functionalities:
- Added database models for communities, image uploads, and details.
- Introduced a settings page to update user details, including profile images.
- Created communities under posts:
- Users can now join, leave, add, and remove communities.
- Community membership is visible to all users.
- Integrated maps and image galleries within each post.
- Enhanced the private chat interface with fully functional AI integration.
- Currently working on updating the image gallery and map pins from the database.
You can check the 1-minute demo of the current functionality at the following URL: Watch the demo
/: Home page/post: List of all posts/map: Map page showing example pins and data/about: About page with information about the platform and future goals/login: Login page for user authentication/chat: Chat interface (currently not fully functional)/register: Registration page for new users/post/add: Page to add a new post/post/[post_id]: Detailed view of a specific post/post/[post_id]/edit: Page to edit a specific post/settings: User settings page for updating profile picture
This project would not have been possible without the incredible support and resources provided by the Reflex team. Their comprehensive documentation and ready-made component templates were invaluable. Additionally, special thanks to masenf for creating the reflex-local-auth library, which greatly simplified the authentication process.
This project is licensed under the MIT License. For more details, see the LICENSE file.