Skip to content

Metternich11/FreeYourStuff-BE

 
 

Repository files navigation

Free Your Stuff

Idea

A mobile-first platform designed to help facilitate the culture of giving away your unused/unwanted items away to people who need them more then you!


logo of app


Motivation

A common practice in the city of Tubingen, Germany, was that people would leave their unwanted items in the street with a sign saying "For Free". I appreciated the idea, and the recycling culture, however also noticed some problems such as:

  • Only immediate passes by would be able to take them
  • Things would be left out for multiple days
  • Also in bad weather
  • Some people would leave undesirable stuff (trash)

There are platforms that try to help, however they are poorly designed, often requiring long descriptions to be able to past an app, and hard to navigate

This app is currently able to solve all these problems by:

  • One click uploading
  • geoloaction of items dropped
  • photo recognition enabling smart tagging

plus many more features to come!

Screenshots


screen shots of app


Getting Started

Prerequisites

  • Node
  • Npm
  • MongoDb
  • Cloudinary
  • Google Api Key
  • Free Your Stuff back-end

Installing

  1. Clone both the Free Your Stuff front-end and the Free Your Stuff back-end
  2. In the command line, for both repos, enter:
npm install

on the front end

  1. Add in your Google Api Key
  2. Add in your Cloudinary Account

on the back end

  1. Create a .env file - following the .env.example

To start

on the front end

npm start

on the back end

npm run dev

Next Steps

As previously mentioned I have a huge list of features that I am planning to implement including:

  • Tests!
  • login/ authentication & user accounts
  • weather recognition (if weather is bad, don't leave things out!)
  • user messages
  • ability to gift things person to person
  • messages between users
  • etc etc

Tech Stack

  • React - The frontend framework used
  • Koa - The backend framework used
  • MongoDb - The database used
  • Cloudinary - The photo-storage database
  • Google Api's - Api's for Maps and Photo-Recognition

Contributing

Contributions Welcome!

This is an on-going project and external input and ideas will be gladly recieved!

License

This project is licensed under the MIT License, take it, have fun.

About

The server side of Free Your Stuff

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%