Petopia

Petopia is a web platform designed for pet lovers to browse for adoption or sale of pets.

Description

Petopia helps pet lovers find and adopt or purchase pets while promoting ethical practices in pet ownership. Users can:

• Browse available pets.
• Post detailed pet listings for adoption or sale.
• Add pets to cart and checkout.

Features

• Pet Categories: Organize pets into different categories for easier browsing.
• Pet Details Page: Each pet listing includes comprehensive information
• Search & Filters: Users can search for pets based on categories, breed, type, etc
• Admin Panel: Manage orders and pets listings through a dedicated admin interface.
• Cart Management: Allows users to add pets to their cart for future adoption or purchase.
• Checkout: Streamlined process to complete the adoption or purchase of pets.

Video Demonstration

• Click here to watch the video

Video Preview

PETOPIA.DEMO.mp4

Installation

1. Download the Github repository

git clone https://github.com/judeo-s/Petopia.git

2. Navigate to the project directory

cd Petopia

3. Installing all the required packages

pip install -r requirements.txt

4. Run the application

python3 app.py

• or use the following if you are working with windows terminal or ubuntu with wsl

python app.py

Usage

1. For user panel, go to http://127.0.0.1:5000/.
2. For admin panel, go to http://127.0.0.1:5000/admin.
3. Username for admin panel is admin and password is password.
4. Users can use the search bar to browse pets for adoption/sale.
5. Users can add pets to cart and checkout.
6. Users can manage their listings through the admin panel.

Contribution Guidelines

• Fork the repository.
• Create a new branch (git checkout -b feature/your-feature-name).
• Commit your changes (git commit -m 'Add some feature').
• Push to the branch (git push origin feature/your-feature-name).
• Open a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

The Team

Three members collaborated as a team in the development and completion of Petopia.

The team members are as follows:

• Jude Osam-Sackey (https://github.com/judeo-s)
• Sadik Adams (https://github.com/PoisebTechHub)
• Cleveland Ataafi (https://github.com/thatguykwameC)

Thank you for using Petopia!