PetQuest: A Pet Adoption System | MERN Stack Portfolio with Admin Panel

"PetQuest" is a website where you can either give a pet up for adoption or adopt one. If you have a pet you can't care for anymore, you fill out a form. The admin then decides if they can put your pet on PetQuest. If they approve, they'll ask you to bring the pet to an adoption center.

If you want to adopt a pet, you fill out a form with your details. The admin gets a lot of requests and picks the best one. If they choose you, they'll delete the other requests and take the pet off PetQuest . They'll keep a record of the pet and your contact info.

So, PetQuest makes it easy to find new homes for pets and connect them with people who want to adopt.

Introduction

PetQuest is a web application that connects pet lovers with pets in need of a home. Our platform simplifies the process of pet adoption by providing a seamless user experience.

Features

• Users can submit a pet for adoption by filling out a form.
• Admin reviews adoption submissions and can approve or reject them.
• Approved pets are listed on PawFinds for potential adopters to view.
• Users interested in adopting a pet fill out an application form.
• Admin evaluates adoption applications to select the most suitable adopter.
• Admin maintains a history of adopted pets and their new owners.
• User can browse and search for available pets for adoption.
• They can filter pets based on pet type i.e. dog, cat, fish, etc.
• PetQuest offer detailed pet profiles with photos and descriptions.

Technology Stack

PetQuest is built using the MERN stack (MongoDB, Express.js, React, Node.js).

Installation

Follow these steps to set up the project locally:

1. Clone the repository: git clone https://github.com/darshdeep38/PetQuest.git
2. Install dependencies: npm install
3. Create a .env file in server with mongooseURL variable set to your MongoDB connection URL in the format mongooseURL=mongodb://username:password@host:port/database_name.
4. Run the server: nodemon server runs the server using nodemon, a tool that enhances the development experience by automatically restarting the server on file changes.
5. npm start to start front end.

Additional Notes

• Ensure you have Node.js and npm installed on your machine.

Contributing

We welcome contributions to improve PawFinds! To contribute, follow these steps:

• Fork the repository.
• Create a new branch: git checkout -b feature-new-feature
• Make your changes and commit them: git commit -m 'Add new feature'
• Push to the branch: git push origin feature-new-feature
• Create a pull request explaining your changes.