Qarma is an online platform to report and retrieve lost & found objects for travelers abroad.
Frontend: HTML, CSS
Backend: Ruby on Rails
This project was built on October 14-15, 2017 as part of the Geek Girls Carrots Berlin Travel Hackathon.
Our app is integrated with Facebook. That way, sign up is quick and authentication is secure.
Upon registering, users receive a unique ID. This ID can be generated as either a numeric or QR code and recorded on their belongings.
If something gets lost, registered users can post a note with a description of the item.
When something is found, the 'finder' can follow the code to the owner's public profile. From there, they can send an email and arrange a way to return the item—no login required!
- Ruby (v2.4 or higher)
- Rails (v5 or higher)
Rails Girls has a great installation guide to setup your software and developer environment.
You'll also need a Facebook authentication key—which can be provided by one of the admins.
Here's how you can get up and running with this project.
- Clone this repository
git clone https://github.com/lcorr8/qarma.git
cd qarma/
- Install dependencies
bundle install
- Apply any missing database migrations
rake db:migrate
- Run the project locally
rails s
# open https://localhost:3000 in your browser to view home page
While we're definitely proud of what we accomplished in less than 36 hours, we have big dreams for Qarma. Some of the future features we envision for this project include:
-
A reward point system for people who find lost items, working name is "Qarma Points"
-
Eliminating the need to share any private information at all and facilitate the entire communication process between item owners and item finders
-
Incorporating the GPS coordinates of finders so the owner can know where their item is in the world
-
Allowing registered users to input credit card details so mailing labels can be printed automatically and the lost item can be easily sent back
Code: Laura Correa, Hyeonjeong Lee, Carolyn Stransky
Design: Marianne Weidlich
PM: Mirre Snelting