COVID-19 Vaccine Spotter
SHUTDOWN PLANNED: VaccineSpotter.org will wind down operations on September 23, 2021. See the shutdown notice for more details. This code will remain available if it’s of interest, but I haven’t been actively working on things in a few months now, so I think it’s time to consider this chapter closed.
A tool to help you track down COVID-19 vaccine appointment openings at your state’s pharmacies. The code behind https://www.vaccinespotter.org.
UI Development Setup
- Node.js 14+
This process is clunky right now, so my apologies.
- Clone the repo:
git clone https://github.com/GUI/covid-vaccine-spotter.git
- Install dependencies (inside the repo):
- Fetch data from the API for the website to run:
- To run the development server for the website:
yarn dev. The development site should then be available at http://localhost:3000/.
DB and Backend Development Setup
docker-compose is used to bring up a local postgres DB. Then an image runs to bootstrap the database with states and postal codes. Finally, as an example of a backend task running, a container runs the
docker-compose build docker-compose up
To run additional tasks, you can use
docker-compose run --rm --no-deps task_runner bin/refresh-cvs
Very Beta API
All of the data being collected is published as JSON files here: https://www.vaccinespotter.org/api/
Subscribe to this discussion for any announcement of API changes: https://github.com/GUI/covid-vaccine-spotter/discussions/27
Website Language Translations
If you would like to help translate the website content into other languages, thank you! You can perform translations and add additional languages at Localazy.
Developer Translation Workflow
- If you’re adding new text to the website, just wrap the English text with the
$t('my text here...').
- In order to translate these strings into other languages, and you have permissions to Localazy, then the steps are:
./bin/run locale:extractto extract any new strings into the
./bin/run locale:uploadto upload the updated
website/lang/messages.potfile to Localazy.
- After translations are performed, run
./bin/run locale:downloadto download the resulting language files.
This project is licensed under the terms of the MIT license.