Repository navigation
Home
cheyras edited this page Sep 23, 2026
·
11 revisions
DeckPal is an open-core TCG collection platform deployed on Vercel + Supabase (cloud) or plain Postgres (self-host). Browse a full card catalog, track your collection across printings, see prices, explore the Pokedex, build decks with battle-log intelligence, scan cards, and set completion goals.
The repo is AGPL-3.0 and lives at github.com/cheyras/deckpal.
| Page | What it covers |
|---|---|
| Administration | Owner/contributor guide: roles, tools, account access, defaults, credit pricing, checkout and payment operations. |
| Architecture | System architecture, RLS model, storage, sync design. Note: the canonical copy is ARCHITECTURE.md in the repo; this wiki page adds deep-dive context. |
| Data Layer | Catalog ingest, prices, images, storage engine, sync jobs -- the feasibility and sizing research that shaped the architecture. |
| Frontend Research | Frontend stack selection, virtualization, image delivery, offline/PWA, build strategy. |
| Capacitor iOS Research | Archived 2026-09-01 scanner-platform investigation: seven iOS issue reports, context and original search snapshot. |
| Rip Voice Gateway Research | 2026-09-22 conditional research recommendation on streaming transcription, later sound, and required iPhone validation; not an adoption decision. |
| Variant Image Source Research | 2026-09-22 source-discovery result: one manually inspected Caterpie normal/reference and reverse-holo pair (n=1); classifier and licensing work remain open. |
| Ink-Tell Era Survey | 2026-09-22 partial all-era ink research: two exploratory manual comparisons (EX and SV); classifier validation remains open. |
| Dex Data | Species mapping, sprites, capture semantics -- how TCG cards link to the National Pokedex. |
| UI Spec | Design tokens, component inventory, layout measurements -- the visual contract the frontend is built against. |
| MCP Setup | Connecting an AI assistant to your collection -- OAuth 2.1 "Connect" flow (works with any MCP client), personal access tokens as a fallback, verification, and revocation. |
| Page | What it covers |
|---|---|
| Prior Art | What to borrow, what to avoid, license posture -- analysis of existing self-hosted TCG collection apps. |
| Project Brief | The original mission brief that launched the project (historical). |
| Decision Log | Snapshot of the running decision log. The living version is DECISIONS.md in the repo. |
| Foil Branch Log | Pre-deletion archive of the eight foil/* branches -- 465 commit messages, 76k words of foil measurements and reasoning that exist nowhere else, plus every branch tip SHA. |
| Page | What it covers |
|---|---|
| Contribution Record | Attribution ledger -- who contributed what, and which agent worked on whose behalf. |
These documents live in the repo because they are tightly coupled to the code:
| Document | Location | What it covers |
|---|---|---|
ARCHITECTURE.md |
repo root | Canonical architecture (the wiki page adds deep dives) |
DECISIONS.md |
repo root | Living decision log (the wiki page is a snapshot) |
AGENTS.md |
repo root | Engineering contracts for all contributors |
CONTRIBUTING.md |
repo root | Human contributor onboarding |
DEPLOYMENT.md |
repo root | Deploy-your-own runbook |
SECURITY.md |
repo root | Security model and disclosure policy |
research/SCHEMA.md |
research/ | Data model, variant taxonomy, tier/goal derivation |
README.md |
repo root | Project overview |
Last updated by Codex / Ringer on behalf of @cheyras -- 2026-09-22