Open Source Programs

PetMe is ready for Hacktoberfest

About the project:

Tech Stack:

PetMe

"Bringing Hearts and Paws Together"

Don't forget to join our official Discord Channel for discussions and updates.

Inspiration for the Project:

It has been estimated that more than one million adoptable dogs and cats are euthanized in the United States each year. This happens for the reason that there are too many pets that are enrolled into shelters and only a few people consider adoption when they look out for a pet.

When our team heard about the animals that were in danger each year, it became a goal for us to help these speechless beings somehow. After brainstorming for a long time we came up with the idea of PetMe. We believe in the policy of saving animals and thus saving lives. Every life matters and we wish to be the part of the change that is making the same possible.

Features of PetMe at a Glance

The test site for the project can be found here.

Function	Feature	Image
Adopting a Pet	Allows user to choose an animal they wish to adopt and submit their details for contact purposes
Donating a Pet	Pet owners can donate their pets if they are unable to take care of the ones they have
Emergency care for Stray Animals	Provide contact details to get emergency medical services
Support PetMe	Allows users to become volunteers for PetMe and submit their details for contact purposes
Pet News	PetMe provides users with several stories on the latest news in the pet world
Blogs	PetMe also has a blogs section dedicated to pet lovers and their pet stories

---

Watch the video:

For a brief explanation about PetMe, you can watch the following video.

Additional features:

• All the data is stored in the database so when a person wishes to adopt or donate an animal, their information will be auto-filled using the database.
• The language of the website can also be translated to different languages by using the Google Translate button in the top right corner of the header.
• Users can click on the moon/sun button in the top right corner of the header to switch between light and dark mode for the website.
• Users can use the Contact page to drop in their details for a call with one of the team members.
• Users can subscribe to PetMe's newsletter to get the latest news and updates by entering their email in the subscription box located in the footer of every page.
• There is a help button located in the bottom right corner of the SOS Report page that allows users to enter their city and find the nearest pet care centers.
• Users can find the organization's social media accounts in the bottom right corner of the footer of every page.

View our Website:

Click the image below to view our website!

Accomplishments:

We are proud to build a website where pet lovers can easily adopt animals that need a home. They can not only provide medical assistance to them but can also allow their fellow comrades in the community to adopt them.

What's next for PetMe 📲

In future, we plan to scale this application to reach as many people as possible and facilitate adoption and donation of animals.

Furthermore, we plan to connect with the nearest government organization that provides medical assistance to stray animals.

---

⭐ How to get started with open source?

You can refer to the following articles on the basics of Git and Github.

• Watch this video to get started, if you have no clue about open source
• Forking a Repo
• Cloning a Repo
• How to create a Pull Request
• Getting started with Git and GitHub

Contributing 👨‍💻

💥 How to contribute

• Take a look at the existing Issues or create a new issue!
• Fork the Repo. Then, create a branch for any issue that you are working on. Finally, commit your work.
• Create a Pull Request (PR), which will be promptly reviewed and given suggestions for improvements by the community.
• Add screenshots or screen captures to your Pull Request to help us understand the effects of the changes proposed in your PR.
• DON'T CREATE PRs WITHOUT CREATING ISSUE AND GETTING ASSIGNED

⭐ How to make a pull request (PR)

1. Start by making a Fork of the PetMe repository. Click on the Fork symbol at the top right corner.

2. Clone your new fork of the repository in the terminal/CLI on your computer with the following command:

git clone https://github.com/<your-github-username>/PetMe

3. Navigate to the newly created PetMe project directory:

cd PetMe

4. Set upstream command:

git remote add upstream https://github.com/Susmita-Dey/PetMe.git

5. Create a new branch:

git checkout -b YourBranchName

6. Sync your fork or your local repository with the origin repository:

• In your forked repository, click on "Fetch upstream"
• Click "Fetch and merge"

7. Make your changes to the source code.

8. Stage your changes and commit:

⚠️ Make sure not to commit package.json or package-lock.json file

⚠️ Make sure not to run the commands git add . or git add *. Instead, stage your changes for each file/folder

git add public

git commit -m "<your_commit_message>"

9. Push your local commits to the remote repository:

git push origin YourBranchName

10. Create a Pull Request!

11. Congratulations! You've made your first contribution to PetMe! 🙌🏼

For more details, refer to CONTRIBUTING.md file.

😎 Project Maintainers

Susmita Dey

Akshita Gupta

Mudit Choudhary

Thanks to all Contributors 💪

Thanks a lot for spending your time and helping PetMe grow. Thanks a lot! Keep rocking 🍻

License 🛡️

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

Socials