Skip to content

Shopping, Selling, In-app local delivery, Shopping-assistant, Search, Simple user interface

Notifications You must be signed in to change notification settings

Henrychallooo/Epic-Buy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

39 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo

This project presents a modified online shopping web application that adds innovative features to enhance the efficiency and user experience in buying and selling goods online.

Key improvements over traditional platforms include

  • A Shopping Assistant Chatbot offering personalized support through products recommendations and comparisons to help buyers in making informed purchasing decisions.

  • In-app local delivery feature for simplified requesting tracking of local deliveries.

  • A user-friendly interface to support users of all demographics.

These enhancements aim to significantly improve the online shopping experience by providing convenience, reliability, and personalized assistance at every stage of the shopping process

Buy page

Developers:

This project was developed as part of the Final Year Project (FYP) at the University of Dar es Salaam (UDSM) by

  • Henry Challo
  • Fredrick Koka

Table of Contents

Project Gap

Epic Buy addresses gaps in traditional online shopping platforms by offering:

  • A Shopping Assistant Chatbot for personalized product recommendations and comparisons based on conversations.
  • An in-app local delivery feature for direct communication between sellers and delivery drivers.
  • A simple and intuitive user interface designed to support users of various demographics.

Installation

Prerequisites

  • Node.js and npm installed on your machine
  • PostgreSQL database set up and running

Steps

  1. Clone the repository:
    git clone https://github.com/Henrychallooo/Epic-Buy.git
  2. Navigate to the project directory:
    cd Epic-Buy
  3. Install dependencies:
    npm install
  4. Set up environment variables: Create a .env file in the root directory and add your environment variables (e.g., database connection, API keys).
  5. Run the application:
    npm start
    The application will be available at http://localhost:3000.

Usage

  • Browse Products: Use the Buy page to browse products and add items to your pay list.
  • Manage Orders: Use the Pay page to track delivery and review your purchase history.
  • Sell Products: Use the Sell page to post new products and manage orders.
  • Handle Deliveries: Drivers can accept delivery requests and track routes via the Driver page.
  • Discover New Products: Use the Discover page to explore products and interact with the Shopping Assistant Chatbot.

Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch git checkout -b feature-branch
  3. Commit your changes git commit -m 'Add new feature'
  4. Push to the branch git push origin feature-branch
  5. Create a pull request.

User Interfaces

The User Interface of Epic Buy consists of several key pages:

  1. Sign-Up/Sign-In Pages: Allow users to register and log in to the system.

Sign-Up

EpicBuy

Sign-In

EpicBuy

  1. Buy Page: Enables buyers to browse products, view details, and add items to their pay list.

Buy Page

EpicBuy

Product's details

EpicBuy

  1. Pay Page: Manages orders, tracks delivery, and provides purchase history.

Pay Page

EpicBuy

Track Delivery progress

EpicBuy

Track delivery driver's current location on a map EpicBuy

  1. Sell Page: Allows sellers to post products, manage orders, and request delivery services.

Sell Page

EpicBuy

Edit profile

EpicBuy

Post products

EpicBuy

Manage orders

EpicBuy

EpicBuy

Request delivery

EpicBuy

EpicBuy

EpicBuy

  1. Driver Page: Enables drivers to accept delivery requests and track routes.

Driver's page

EpicBuy

Track delivery routes

EpicBuy

Edit driver's profile

EpicBuy

  1. Discover Page: Allows buyers to discover new products and interact with the Shopping Assistant Chatbot.

Discover page

EpicBuy

Search products

EpicBuy

Shopping Assistant Chatbot

EpicBuy

EpicBuy

EpicBuy

Technologies Used

  • Frontend: ReactJS, HTML, CSS, JavaScript
  • Backend: JavaScript
  • Database: PostgreSQL
  • UI Design: Figma
  • APIs: Google Maps API, Firebase Authentication API
  • Version Control: Git

This README provides a comprehensive guide to understanding, installing, and contributing to the "Epic Buy" online shopping application. It also details the project's innovative features and system implementation.