Skip to content

lcorr8/qarma

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
app
 
 
bin
 
 
 
 
db
 
 
lib
 
 
log
 
 
 
 
 
 
tmp
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Qarma

Qarma is an online platform to report and retrieve lost & found objects for travelers abroad.

screen shot 2017-10-15 at 13 59 03

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.

How Qarma Works

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!

Requirements for Development

  • 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.

Quickstart

Here's how you can get up and running with this project.

  1. Clone this repository
git clone https://github.com/lcorr8/qarma.git
cd qarma/
  1. Install dependencies
bundle install
  1. Apply any missing database migrations
rake db:migrate
  1. Run the project locally
rails s
# open https://localhost:3000 in your browser to view home page

What's Next?

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

The Team Behind Qarma

Code: Laura Correa, Hyeonjeong Lee, Carolyn Stransky
Design: Marianne Weidlich
PM: Mirre Snelting

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published