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
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
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.
- Node.js and npm installed on your machine
- PostgreSQL database set up and running
- Clone the repository:
git clone https://github.com/Henrychallooo/Epic-Buy.git
- Navigate to the project directory:
cd Epic-Buy
- Install dependencies:
npm install
- Set up environment variables: Create a
.env
file in the root directory and add your environment variables (e.g., database connection, API keys). - Run the application:
The application will be available at
npm start
http://localhost:3000
.
- 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.
We welcome contributions! Please follow these steps:
- Fork the repository.
- Create a new branch
git checkout -b feature-branch
- Commit your changes
git commit -m 'Add new feature'
- Push to the branch
git push origin feature-branch
- Create a pull request.
The User Interface of Epic Buy consists of several key pages:
- Sign-Up/Sign-In Pages: Allow users to register and log in to the system.
- Buy Page: Enables buyers to browse products, view details, and add items to their pay list.
- Pay Page: Manages orders, tracks delivery, and provides purchase history.
Track delivery driver's current location on a map
- Sell Page: Allows sellers to post products, manage orders, and request delivery services.
- Driver Page: Enables drivers to accept delivery requests and track routes.
- Discover Page: Allows buyers to discover new products and interact with the Shopping Assistant Chatbot.
- 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.