Giter Club home page Giter Club logo

freebay's Introduction


A website where users bid on fake products with fake money!
View Live App


About The Project

FreeBay is an eBay clone that allows users to search for and bid on fake products. Each product has an auction time limit and the user with the highest bid at the end of the limit, "wins" the product. Notifications are sent to users based on activity within the app such as, winning a product, being outbid, or receiving a daily reward. A user's notifications, highest bids, and products won can all be viewed on their profile. All profiles are public, however notifications can only be seen by the owner.

Once a user creates an account, they receive $100 freeBay bucks to bid on products. They can also receive $100 each time they login on a separate day. On a product's detail page, a user can see all of the products information along with an auction countdown timer and the current bidder.

Each product's condition, rating, number of ratings, and auction end time are generated randomly, however all other product data is in freeBay has been scraped from a variety of Amazon's Best Sellers web pages using Python. The products are then pulled and manipulated to the frontend website by calling the backend API. Since auction starting prices are usually lower than the item's market price, each product's starting bid is 2/3 of the scraped Amazon price.

Built With

The coding languages, frameworks, and libraries that I used to build this project:

Frontend

Backend

How to Run the Project

To get a local copy up and running follow these steps:

Clone Repos

  1. Clone the frontend repo by clicking Download Zip from the green Code button at the top of the page or enter the following in the desired directory in your terminal:
    git clone https://github.com/Bolmstead/freebay-frontend.git
  2. Clone the backend repo to a separate directory by going to https://github.com/freebay-backend. From there, click Download Zip again from the green Code button at the top of the page or enter the following in a separate directory in your terminal:
    git clone https://github.com/Bolmstead/freebay-backend.git

Library Installations

  1. After cloning each repo (and unzipping if downloaded), install the libraries in each frontend and backend repo.

    npm install

Postgres Installation

  1. Install Postgres.
  2. Create a database named "freebay" in your terminal in the backend directory.
    createdb freebay

Seed Products to Database

  1. Run the following command in your terminal in the backend directory to create the database tables and seed products to database.

    psql -d freebay -f SeedTablesAndProducts.sql
  2. Start servers in both frontend and backend directories and you are done!

Roadmap

Stretch goals for this project:

  • Search filter box for a list of searched products.
  • Users add their own products and ratings for products they've won.
  • Websocket chat feature.

Contact

Berkley Olmstead - [email protected] - Linkedin

Project Links:
Live Site
https://github.com/freebay-frontend
https://github.com/freebay-backend

freebay's People

Contributors

bolmstead avatar berkleydev avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.