Fast scrape
make fetch-test scrapes 10 entries without images.
Run locally
Install
Use Python 3.11+ and uv. The reference Pokedex JSON is already shipped, so the UI starts without scraping first.
1. Local server
Recommended for development and everyday use.
git clone https://github.com/Boblebol/pokevault.git
cd pokevault
make install
make dev2. Docker
Build and run the tracker container on localhost.
make docker-build
make docker-up
make docker-logsData files
Readable JSON, versionable if you want it.
| Path | Purpose |
|---|---|
data/pokedex.json | Tracked reference Pokedex shipped with the repository. |
data/narrative-tags.json | Tracked narrative tag definitions. |
data/game-pokedexes.json | Tracked game Pokedex definitions and appearances. |
data/collection-progress.json | Local user progress and badge unlocks. |
data/binder-*.json | Local binder configuration and placements. |
Useful commands
Scrape, test and export.
Full scrape
make fetch refreshes the Pokedex and sprite images.
Quality gate
make check runs lint and tracker coverage.