luvnft/adopt-

PawsitiveAdoptionHub, developed within 24 hours for Geekathon Hackathon 2023, is a user-friendly pet adoption platform. It streamlines pet adoptions with advanced search, detailed profiles, and community engagement features, fostering responsible pet ownership.

PawsitiveAdoptionHub

PawsitiveAdoptionHub is a comprehensive pet adoption platform designed to simplify the pet adoption process and connect pets in need with caring individuals or families.

Features

• Advanced Search Filters: Refine pet searches based on species, age, size, and more.
• Detailed Adoption Profiles: View comprehensive pet profiles with photos and essential details.
• Collaboration with Shelters: Partnerships with local shelters to showcase available pets.
• User Reviews: Share adoption experiences and provide feedback for informed decisions.
• Digital Pet Health Records: Manage and access pet health records for adopted pets.
• Step-by-Step Adoption Guidance: Guidance and checklists for the adoption process.
• Lost and Found Section: Report and search for lost or found pets.
• Pet Care Resources: Access articles, guides, and FAQs on pet care.
• Vet Directory and Services Locator: Find vet services and pet-friendly locations.
• Vibrant Pet Community Forum: Engage with a community of pet enthusiasts for advice and experiences.

Technologies Used

• Frontend: HTML, CSS, JavaScript, Bootstrap
• Backend: Django (Python)
• Database: PostgreSQL
• Additional Tools: Git, GitHub

Installation

1. Clone the repository:

   git clone https://github.com/Shashaaankkkkk/PawsitiveAdoptionHub.git

2. Setup Python environment and install dependencies:

   cd PawsitiveAdoptionHub
   python -m venv venv
   source venv/bin/activate (For Windows: venv\Scripts\activate)
   pip install -r requirements.txt

3. Configure the database in settings.py:

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql',
           'NAME': 'your_db_name',
           'USER': 'your_db_user',
           'PASSWORD': 'your_db_password',
           'HOST': 'localhost',
           'PORT': '5432',
       }
   }

4. Apply migrations and start the server:

   python manage.py makemigrations
   python manage.py migrate
   python manage.py runserver

5. Access the application at http://127.0.0.1:8000/ in your browser.

Contribution

Contributions are welcome! If you want to contribute to this project, please follow these steps:

1. Fork the repository
2. Create a new branch (git checkout -b feature)
3. Make changes and commit (git commit -am 'Add new feature')
4. Push to the branch (git push origin feature)
5. Create a pull request

License

This project is licensed under the MIT License.

Screenshots

Home Screen

Pet Search

Pet Profile

Adoption appointment

Community Forum

Vet Listing

Vet Profile

Vet Appointment