Pokémon Card Viewer is a touch-friendly Flask application for browsing a local catalogue of Pokémon Trading Card Game cards. It is designed to work well on a shared tablet or kiosk: cards can be searched and filtered, shown one at a time, and revisited with Back and Next controls.
Each person can select or add a simple profile and keep an independent list of favourite cards. Profiles and favourites are stored in the local SQLite card database, so they remain available after a browser refresh or service rebuild.
- Random card browsing with Back/Next history and optional auto-rotation.
- Search suggestions and filters for game, generation, type, rarity, and card kind.
- Full card details and cached high-resolution card images.
- Separate favourite-card lists for each selected user.
- A metadata sync pipeline that imports cards from the Pokémon TCG API.
- Docker Engine with Docker Compose v2.
- Optional: a Pokémon TCG API key for faster metadata syncing. The app works without one.
git clone git@github.com:stevenshrago/PokemonTCGCardServer.git
cd PokemonTCGCardServer
docker compose up -d --build webOpen http://<server-address>:8090 in a browser. The data/ directory is
mounted into the web container and retains the SQLite database, image cache,
profiles, and favourites when the image is rebuilt.
The sync job uses the Pokémon TCG API and may take a while for a full catalogue update. To use an API key, set it in the environment before running the job:
export POKEMONTCG_API_KEY="your-api-key"
docker compose --profile sync run --rm syncWithout a key, omit the export command. Existing card data is updated in
place; user profiles and favourites are retained.
Pull the latest source and rebuild the web service:
git pull
docker compose up -d --build webThe app sends no-cache headers for its HTML, JavaScript, and stylesheet, so a browser reload receives the updated interface.
Use the User picker to choose a profile, or use + to add one. Tap the heart beside a card to add or remove it from that user's favourites. Open Filters and select that user's Favourites to browse only their saved cards.
Profiles are intended for a shared family device, not secure authentication: anyone with access to the viewer can select a profile. See ARCHITECTURE.md for the system design and API details.