anshumaantgi / StuBid

0 stars 0 forks source link


Logo

StuBid

StuBid, also known as 'Student Bidding', is a one-stop mobile application for all students studying in Singapore Universities to conveniently buy or sell unwanted items online through an anonymous bidding system, maximizing the benefits gained by both the seller and buyer.

Explore the docs »

View Figma Demo

Table of Contents
  1. About The Project
  2. Getting Started
  3. Contact

About The Project

Logo

Our Aim

We aim to create a one-stop online marketplace, a mobile application which allows students from all Singapore Universities to conveniently buy or sell unwanted items online through an anonymous bidding system, maximizing the benefits gained by both the seller and buyer.


How it Works?

Sellers can upload a photo and the relevant details of their item and set a starting bid of the item. Any interested buyers who search for the item can make a bid higher or equal the starting bid for the item. If the Seller is satisfied with the price bid by the item, he or she can accept the bid offered. Once the bid is successfully accepted, seller and buyer can start to interact and exchange contact information with each other for the transaction to occur. Upon successful transaction, both seller and buyer can leave a review for each other.

(back to top)

Built With

(back to top)

Getting Started

Use either of the two ways listed below to initialise/load the app.

1. Either initialise the app locally, then run the app.

Prerequisites

  1. Get ready your physical device.
  2. Download the Source Code from the repo, Main Branch.
  3. Open and run the terminal on the source code directory.
  4. Install all neccessary dependencies and libraries with the code below.
  5. Run CLI command:
    npm install
  6. Run CLI command:
    expo upgrade
  7. To start the app, run the following CLI command:
    npm start

Installation

  1. Download the Expo Go App
  2. Register for an Expo account (if you do not have an account)
  3. Login into the Expo Go App with your account
  4. On your terminal (in the source code directory)
  5. Run CLI command:
    expo start
  6. Scan the QR appearing in the terminal
  7. You should be redirected to Expo and App should load on your physical device.

Note : If any errors are encountered please contact one of the developers below, contact information is listed below.

2. Or run the app without downloading the source code (Fast Method)

Installation

  1. Get ready your physical device.
  2. Download the Expo Go App
  3. Login into the Expo Go App with the following Credentials
    Username: stubiduser2122@gmail.com
    Password: testuser2122
  4. Then enter this link in the mobile browser: https://expo.dev/@brannn99/StuBid
  5. Scan/Tap QR code on the link
  6. App should load and run on your physical device

Note : If any errors are encountered please contact one of the developers below, contact information is listed below.

Contact

Developers

  • Anshumaan Tyagi - e0866249@u.nus.edu - Telegram: @a_tgi
  • Bransome Tan Yi Hao - e0726931@u.nus.edu - Telegram: @brannn99

Project Link: https://github.com/anshumaantgi/StuBid

(back to top)