https://github.com/SylviaChebetEMTH/UrbanBazaar
UrbanBazaar is a web-based e-commerce platform designed to simplify online shopping by offering a vast selection of products across categories like electronics, mobiles, clothes, groceries etc. Built with React for a dynamic front-end and Flask for a robust back-end, the platform ensures a seamless user experience.
https://github.com/SylviaChebetEMTH/UrbanBazaar
flask javascript python reactjs sqlalchemy
Last synced: 6 months ago
JSON representation
UrbanBazaar is a web-based e-commerce platform designed to simplify online shopping by offering a vast selection of products across categories like electronics, mobiles, clothes, groceries etc. Built with React for a dynamic front-end and Flask for a robust back-end, the platform ensures a seamless user experience.
- Host: GitHub
- URL: https://github.com/SylviaChebetEMTH/UrbanBazaar
- Owner: SylviaT01
- License: mit
- Created: 2024-07-29T16:08:54.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-16T09:26:07.000Z (almost 2 years ago)
- Last Synced: 2025-03-22T13:27:44.518Z (over 1 year ago)
- Topics: flask, javascript, python, reactjs, sqlalchemy
- Language: Python
- Homepage: https://urban-bazaar-red.vercel.app/
- Size: 47.2 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# UrbanBazaar
## Introduction
UrbanBazaar is a web-based e-commerce platform that offers a comprehensive list of products across various categories like electronics, mobiles, clothes, and groceries.
## Minimum Viable Product(MVP) Features
The MVP of UrbanBazaar will include the following features:
- **User Authentication**
- Login
- Registration
- Forgot Password
- **Product Browsing**
- Browse products by category
- Search products by name or description
- Browse products by brand
- **Shopping Cart**
- Add products to cart
- View cart contents
- Remove products from cart
- **Order Checkout**
- Simulate a payment process internally
- Display order summary
- Generate address, billing information, and invoices for every order submitted
## Admin Features
- **Product Management**
- Perform CRUD (Create, Read, Update, Delete) operations on products
- **User Management**
- Add users with specific roles to manage products and orders
- **Analytics**
- View analytics for different products within the platform
- View analytics for orders made by customers
## Technical Stack
- **Backend**: Python with Flask
- The backend handles CRUD operations, user management, and analytics processing.
- **Frontend**: ReactJS
- The frontend renders product listings, manages the shopping cart, and simulates the checkout process.
- **Wireframes**: Figma
- Figma designed Wireframes to visualize the layout and user flow before implementation.
## Get Started
1. Clone the repository
```bash
git clone git@github.com:SylviaT01/UrbanBazaar.git
```
2. Install dependencies
```bash
npm install
```
```bash
pipenv install
```
3. Enter virtual environment(Backend)
```bash
pipenv shell
```
4. Start the Flask server
```bash
python app.py
```
5. Start the React development server
```bash
npm start
```
## Requirements
- Programming knowledge (HTML, JavaScript, Python and SQL)
- Visual Studio as code editor
- Basic understanding of web development and design principles
- Familiarity with React and Flask frameworks
- Experience with databases and SQL queries
## Contributions
Contributions are welcome! If you'd like to contribute, please fork the repository and submit a pull request.
## Authors
- [Sylvia Chebet](https://github.com/SylviaT01)
- [Wilfred Ketere](https://github.com/WLemmy)
- [Morris Mburu](https://github.com/mrrsmburu)
- [Lewis Wambugu](https://github.com/Wambuguu)
- [Uwes Ahabab](https://github.com/ahabab23/ahabab23)
## Copyright and License Information
The project is licensed under [MIT License](LICENSE)