search

sameersrivastava13 / Vaccine-Tracker-App

Check Your Nearest Vaccination Center And Slots Availability using pincode and district name.
https://vaccine-tracker-app.netlify.app/
MIT License
67 stars 53 forks source link

readme

Vaccine Tracker Application - Pan India 💉

Website   •  Playstore

image

1

made with ♥ for the people of India

DevIncept is an 30 day open source program helping the student community learn and contribute in various open source project under the guidance of skilled mentors and project admins.

Devincept

🎯 Purpose of the Project

With more cases piling up in the country, experts have appealed to people to get themselves vaccinated at the earliest. The studies have shown that even people, who have received just one jab can have enough immunity to endure Covid-19 and there there is less risk of getting into a serious condition.

However, the state-run Co-WIN website, which offers people to get appointments for vaccination at the nearest health centres, is inundated with millions of requests. This has caused the website to crash and sometimes show an error message.

The application will help user check the availability of vaccination slots for a specific date by individually entering different PIN codes or district details along with the age group (18+ or 45+). If there are no slots available, users can subscribe to email alert service to get notification as soon as slots are avaialble in there area.

The data is sourced on a real-time basis from the CoWIN API, which is the official government platform to book slots for vaccination.

PROJECT MAINTAINER -> Sameer Srivastava

PROJECT MENTOR -> Sejal Panjwani

🏁 Technology Stack

🏃‍♂️ Local Installation

  1. Drop a ⭐ on the Github Repository.
  2. Clone the Repo by going to your local Git Client and pushing in the command: 
https://github.com/sameersrivastava13/Vaccine-Tracker-App.git

  1. Install the Packages: 

    pip install -r requirements.txt

  2. At last, push in the command:

    python app.py

  3. Go to http://127.0.0.1:5000/ and enjoy the application.

Contribution Guidelines🏗

Are we missing any of your favorite features, which you think you can add to it❓ We invite you to contribute to this project and make it better? To start contributing, follow the below guidelines:

1. Fork this repository.

2. Clone your forked copy of the project.

git clone https://github.com/<your_user_name>/Vaccine-Tracker-App.git

3. Navigate to the project directory :file_folder: .

cd Vaccine-Tracker-App

4. Add a reference(remote) to the original repository.

git remote add upstream https://github.com/sameersrivastava13/Vaccine-Tracker-App.git

5. Check the remotes for this repository.

git remote -v

6. Always take a pull from the upstream repository to your master branch to keep it at par with the main project(updated repository).

git pull upstream main

7. Create a new branch.

git checkout -b <your_branch_name>

8. Perform your desired changes to the code base.

9. Track your changes:heavy_check_mark: .

git add .

10. Commit your changes

git commit -m "Relevant message"

11. Push the committed changes in your feature branch to your remote repo.

git push -u origin <your_branch_name>

12. To create a pull request, click on `compare and pull requests. Please ensure you compare your feature branch to the desired branch of the repo you are supposed to make a PR to.

13. Add appropriate title and description to your pull request explaining your changes and efforts done.

14. Click on Create Pull Request.

15 Voila :exclamation: You have made a PR to the Vaccine-Tracker-App project :boom: Sit back patiently and relax while the project maintainers review your PR. Please understand at times the time can vary from a few hours to a few days

CONTRIBUTORS

📜 LICENSE

MIT