Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/akshitagupta15june/PetMe

PetMe is an all-in-one platform that allows animals to be adopted, donated to pet lovers, and provides emergency medical care to stray animals in need. Star this repo⭐
https://github.com/akshitagupta15june/PetMe

collaborate communityexchange educative github github-pages hacktoberfest open-source student-vscode

Last synced: 3 months ago
JSON representation

PetMe is an all-in-one platform that allows animals to be adopted, donated to pet lovers, and provides emergency medical care to stray animals in need. Star this repo⭐

Awesome Lists containing this project

README

        

## Open Source Programs

PetMe is ready for Hacktoberfest



Email Banners-Dark

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 | ![docfix1](https://github.com/5h0ov/PetMe/assets/83227649/df6cbd93-421c-45d2-b11a-9f61b7bba8f8) ![docfix2](https://github.com/stephanienguyens/PetMe/blob/documentation/Assets/Images/adoptionForm.png) |
| Donating a Pet | Pet owners can donate their pets if they are unable to take care of the ones they have | ![docfix3](https://github.com/5h0ov/PetMe/assets/83227649/6e18e6d7-1df5-41fc-841e-866f767763f7) |
| Emergency care for Stray Animals | Provide contact details to get emergency medical services | ![docfix4](https://github.com/5h0ov/PetMe/assets/83227649/5ad9418b-5991-4495-b7a5-1b4fdcb5528d) |
| Support PetMe | Allows users to become volunteers for PetMe and submit their details for contact purposes | ![docfix5](https://github.com/stephanienguyens/PetMe/blob/documentation/Assets/Images/volunteerForm.png) |
| Pet News | PetMe provides users with several stories on the latest news in the pet world | ![docfix6](https://github.com/stephanienguyens/PetMe/blob/documentation/Assets/Images/petNews.png) |
| Blogs | PetMe also has a blogs section dedicated to pet lovers and their pet stories | ![docfix7](https://github.com/stephanienguyens/PetMe/blob/documentation/Assets/Images/blogs.png) |
----

## Watch the video:

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

[](https://youtu.be/U1EQjtT-G8E)

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!

[](https://akshitagupta15june.github.io/PetMe/)

## 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](https://youtu.be/SYtPC9tHYyQ)
- [Forking a Repo](https://help.github.com/en/github/getting-started-with-github/fork-a-repo)
- [Cloning a Repo](https://help.github.com/en/desktop/contributing-to-projects/creating-a-pull-request)
- [How to create a Pull Request](https://opensource.com/article/19/7/create-pull-request-github)
- [Getting started with Git and GitHub](https://towardsdatascience.com/getting-started-with-git-and-github-6fcd0f2d4ac6)

## Contributing πŸ‘¨β€πŸ’»

### πŸ’₯ How to contribute
- Take a look at the existing [Issues](https://github.com/akshitagupta15june/PetMe/issues) or [create a new issue](https://github.com/akshitagupta15june/PetMe/issues/new/choose)!
- [Fork the Repo](https://github.com/Susmita-Dey/all-round-calculator/fork). Then, create a branch for any issue that you are working on. Finally, commit your work.
- Create a **[Pull Request](https://github.com/akshitagupta15june/PetMe/compare)** (_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**](https://github.com/akshitagupta15june/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:

```bash
git clone https://github.com//PetMe
```

**3.** Navigate to the newly created PetMe project directory:

```bash
cd PetMe
```

**4.** Set upstream command:

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

**5.** Create a new branch:

```bash
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

```bash
git add public
```

```bash
git commit -m ""
```

**9.** Push your local commits to the remote repository:

```bash
git push origin YourBranchName
```

**10.** Create a [Pull Request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request)!

**11.** **Congratulations!** You've made your first contribution to [**PetMe**](https://github.com/akshitagupta15june/PetMe/graphs/contributors)! πŸ™ŒπŸΌ

#### For more details, refer to [CONTRIBUTING.md](/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 🍻



[![Contributors](https://contrib.rocks/image?repo=akshitagupta15june/PetMe)](https://github.com/akshitagupta15june/PetMe/graphs/contributors)

## License πŸ›‘οΈ

PetMe is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Socials

[](https://github.com/akshitagupta15june/PetMe)