Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Pokémon Card Viewer

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.

Features

  • 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.

Deploy with Docker Compose

Prerequisites

  • Docker Engine with Docker Compose v2.
  • Optional: a Pokémon TCG API key for faster metadata syncing. The app works without one.

Start the viewer

git clone git@github.com:stevenshrago/PokemonTCGCardServer.git
cd PokemonTCGCardServer
docker compose up -d --build web

Open 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.

Import or refresh card metadata

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 sync

Without a key, omit the export command. Existing card data is updated in place; user profiles and favourites are retained.

Update a deployed copy

Pull the latest source and rebuild the web service:

git pull
docker compose up -d --build web

The app sends no-cache headers for its HTML, JavaScript, and stylesheet, so a browser reload receives the updated interface.

Profiles and favourites

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages