PetMe is ready for Hacktoberfest
About the project:
Tech Stack:
Don't forget to join our official Discord Channel for discussions and updates.
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.
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 |  |
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
Contactpage 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 Reportpage 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.
Click the image below to view our website!
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.
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.
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
- 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
1. Start by making a Fork of the PetMe repository. Click on the 
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>/PetMe3. Navigate to the newly created PetMe project directory:
cd PetMe4. Set upstream command:
git remote add upstream https://github.com/Susmita-Dey/PetMe.git5. Create a new branch:
git checkout -b YourBranchName6. 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:
package.json or package-lock.json file
git add . or git add *. Instead, stage your changes for each file/folder
git add publicgit commit -m "<your_commit_message>"9. Push your local commits to the remote repository:
git push origin YourBranchName10. Create a Pull Request!
11. Congratulations! You've made your first contribution to PetMe! 🙌🏼
For more details, refer to CONTRIBUTING.md file.
 Susmita Dey |
 Akshita Gupta |
 Mudit Choudhary |
Thanks a lot for spending your time and helping PetMe grow. Thanks a lot! Keep rocking 🍻
PetMe is licensed under the MIT License - see the LICENSE file for details.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent