Welcome to the Online Marketplace project! This repository contains the codebase for a web-based marketplace application built using Python, Django, and SQLite3.
- 📌 Project Overview
- 📌 Features
- 📌 Technologies Used
- 📌 Setup and Installation
- 📌 Usage
- 📌 Contributing
- 📌 License
The Online Marketplace project is a web application that allows users to buy and sell products. It provides a platform where users can register, list items for sale, browse items from other sellers, and make purchases. The project aims to simulate a real-world e-commerce environment with essential functionalities.
- User Authentication (Sign Up, Login, Logout)
- Product Listing and Browsing
- Product Search
- Shopping Cart
- Order Management
- User Profile Management
- Python: The core programming language used for development.
- Django: The web framework used to build the application.
- SQLite3: The database system used for data storage.
To set up the project locally, follow these steps:
-
Clone the repository:
git clone https://github.com/nsmunasinghe/Online_Marketplace.git
cd Online_Marketplace
-
Create a virtual environment:
python -m venv venv
-
Activate the virtual environment:
.\venv\Scripts\Activate.ps1
-
Install the dependencies:
pip install -r requirements.txt
-
Apply migrations:
python manage.py migrate
-
Create a superuser (admin):
python manage.py createsuperuser
-
Run the development server:
python manage.py runserver
-
Access the application: Open your browser and go to
http://127.0.0.1:8000/
- Home Page: View the homepage with featured products and categories.
- Sign Up / Login: Register a new account or log in with existing credentials.
- Product Listing: Add new products to sell.
- Product Browsing: Browse available products and use the search functionality.
- Shopping Cart: Add products to the cart and proceed to checkout.
- Order Management: View your orders and order history.
- User Profile: Manage your profile details and view your listings.
Contributions are welcome! Please follow these steps to contribute:
- Fork the repository.
- Create a new branch (
git checkout -b feature/your-feature-name
). - Make your changes.
- Commit your changes (
git commit -m 'Add some feature'
). - Push to the branch (
git push origin feature/your-feature-name
). - Open a Pull Request.
This project is licensed under the MIT License. See the LICENSE file for details.
Feel free to reach out if you have any questions or need further assistance!