tradeQuick

An app that let people within a locality buy/sell used items (ALX portfolio project)

Web URL: https://tradequick.vercel.app

About the project

The web app is a market place for selling used items that someone else might be interested in, the seller uploads certain information such as the photos of it, description and price and the buyer can either comment on the post or send private message. Disclaimer:

1. Every user's security is in his hands. All users are to deal with people within their locality or close range and meet in public places before paying for the goods.
2. The risk of purchasing spoilt or bad items is entirely the users. He/she must test the item very well (if possible) before paying for it.
3. It is safer to buy from store owners but any user can sell or buy on the app, so everyone has got to be very careful while dealing with anyone, as we are not responsible for the outcome of the deal.

Features

1. Logo and attractive user interface
2. Contents are available to the public (Read only)
3. No transaction except authenticated
4. User sign up and authentication
5. User account management (viewing, updating and deleting own account)
6. Items management (viewing, uploading, editing and deleting own items, and marking the sold ones as sold)
7. Search for items (public)
8. Social interaction

• Comment on items for sale
• like/dislike items for sale
• Chat privately with the seller

7. Compulsory mobile number verification
8. SMS and email notifications, based on the user's preference.

Extras

• Support/help
• Portfolio (about the team)
• About (about the app)
• Contact us

Scope

Version 1.0 of the app is designed to be used within Nigeria only

Team

Front End

• Topman Paul-Dike

Back End

• David Gregs
• Otueh Chibueze

Technologies

Programming Languages Used

Front End

• HTML
• CSS
• JavaScript

API

• Python (Flask)

Database

• MySQL

Third Party Services

1. Cloudinary (for photo uploads)
2. Google authentication
3. Facebook authentication
4. Brevo (mailing/SMS services)

Usage/Installation

To install and run the app locally or in a development environment, follow the instructions below:

Front End

# Clone the git repository
:$ git clone https://github.com/tpauldike/tradeQuick.git

# Move into the directory
:$ cd tradeQuick

# Open it with your code editor (VScode for instance)
:$ code .

# Make sure you have the live server extension installed, then render index.html on your browser
# You may as well change the environment variables in the scripts to that of the local server, you're using.

To have the app server and the database-serrver running locally as well , follow the instructions for server installation below:

Back End

(instructions unavailable at the moment...)

Authors

The file AUTHOR.md contains the names of the authors and their email addresses.

Feel free to contribute to the project, outside contributors from February 2024 and not before then, please. You may refer to CONTRIBUTION.md to know how to make an acceptable contribution to this project

© 2023 tradeQuick. All rights reserved.