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 |  |
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.
- Users can use the
Contactpage to drop in their details for a call with one of the team members.
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.
