🐾 Paws & Hearts - Pet Adoption Platform

Making tails wag and hearts purr since 2023 🐱🐕

⚠️ Important Notes

• Responsive Design Status: This website is currently in development and is not fully responsive across all devices. Best viewed on desktop/laptop screens.
• Mobile Navigation: The mobile navigation is currently being optimized for better user experience.
• Development Status: This project is still under development and serves as an example of a pet shop website. Some images may not be available for viewing. You can easily add your own images by uploading them to the src/assets/images/ folder.
• Image Handling: Ensure that the images are named correctly to match the references in the HTML files for proper display.

✨ Features

• 🏠 Modern Homepage with dynamic content and engaging animations
• 🐾 Pet Gallery showcasing adorable pets available for adoption
• 📝 Contact Form for adoption inquiries and general questions
• 🔒 User Authentication system for secure access
• 💝 Donation System to support our cause
• 🎨 Dynamic UI Elements with hover effects and transitions

🚀 Getting Started

Prerequisites

• Any modern web browser (Chrome, Firefox, Edge recommended)
• Live Server extension for VS Code (recommended) or Python for local server

Running the Project

1. Clone the repository

   git clone https://github.com/kunalsahu20/pet-shop.git
   cd pet-shop

2. Start the local server

   # Using Python's built-in HTTP server
   cd src
   python -m http.server 8000
   
   # OR use Live Server in VS Code
   # Right-click on index.html and select "Open with Live Server"

3. Access the website

   • If using Python server: http://localhost:8000
   • If using Live Server: Will automatically open in your default browser

📁 Project Structure

src/
├── assets/
│   └── images/
├── css/
│   └── styles.css
├── js/
│   ├── auth.js
│   ├── script.js
│   └── slideshow.js
├── index.html
├── about.html
├── contact.html
├── login.html
└── pets.html

🎨 Design Features

UI Components

• Navigation Bar: Clean and intuitive navigation with dynamic login/logout states
• Hero Section: Engaging hero section with animated elements
• Pet Cards: Attractive cards displaying pet information
• Forms: Styled forms with validation and feedback
• Buttons: Gradient-based buttons with hover effects

Animations & Effects

• Hover Effects:
  • Navigation links with smooth transitions
  • Buttons with gradient shifts
  • Cards with elevation effects
• Page Transitions:
  • Smooth content loading
  • Fade-in animations
  • Scroll-based reveals

🛠️ Known Issues & Future Improvements

1. Responsive Design:

   • Navigation needs optimization for smaller screens
   • Layout adjustments needed for mobile devices
   • Image scaling improvements required

2. Planned Features:

   • Enhanced mobile navigation
   • Improved responsive design
   • Advanced pet filtering system
   • User dashboard
   • Pet adoption tracking

👥 Contributing

We welcome contributions! If you'd like to help improve Paws & Hearts:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

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

🙏 Acknowledgments

• Icons from Font Awesome
• Images from Unsplash
• Animations powered by AOS Library