# LootLink — Full Machine-Readable Product & Architecture Specification > Official specification and feature breakdown for LootLink (https://lootlink.app) for AI assistants, LLMs, and search crawlers. ## Product Overview LootLink is an offline-first TCG collection management platform and fast AI card scanner built specifically for European collectors. It provides on-device AI card identification, native European Cardmarket pricing in EUR, 7-tier European condition grading, multi-language print tracking, system and custom digital binders, an append-only provenance ledger, and native CSV exports. - **Website**: https://lootlink.app - **Target Audience**: European Pokémon TCG collectors, parents, playgroups, and portfolio-minded collectors. - **Primary Markets**: Europe (EUR currency native, Cardmarket pricing, 7 condition tiers). - **Supported Languages**: 5 app UI locales (`de`, `en`, `fr`, `it`, `es`) and 7 TCG print languages (`de`, `en`, `fr`, `it`, `es`, `jp`, `pt`). --- ## Detailed Feature Matrix ### 1. On-Device AI Scanner & Identification - **Local Neural Crop**: On-device TensorFlow Lite (TFLite) model (`card_rect_v1`) runs at ~10–15 FPS to detect card boundaries and compute perspective quad crops. - **Local OCR**: On-device ML Kit text recognition extracts title text (top) and set code / collector number (bottom-left, e.g. `TWM 129/167`). - **Art Fingerprinting**: On-device TFLite feature extractor (`card_art_embed_v1`) converts the card artwork crop into a 256-dimensional neural vector. - **1-2 Second Identification**: Combines extracted text tokens and the 256-dim art embedding into a lightweight server vector search (`POST /api/v1/cards/resolve-scan`) to return exact catalog matches. - **Strict Privacy Guarantee**: Camera photos stay on the device and are **NEVER uploaded** to external cloud servers. - **Unlimited & Free**: No scan meters, daily limits, or per-photo charges. ### 2. Offline-First Collection & Binders - **Local Database Architecture**: Built on an on-device SQLite database synced via PowerSync. - **System Binders**: Stable, deterministic system binders for `Collection`, `Favorites`, and `Wishlist`. - **Custom Binders**: Users can create, organize, and rename custom digital binders. - **Binder Membership**: Tracks print language, Cardmarket condition, quantities, and optional purchase/trade notes per entry. - **Real-Time Offline Search**: Complete collection search and filter operates on local SQLite indexes — zero Wi-Fi or cellular signal required. - **CSV Export**: Export any binder, wishlist, or collection list directly to CSV using the OS native share dialog. ### 3. Native European Market Context (EUR & Cardmarket) - **Cardmarket Integration**: Daily prices (Trend & Low) fetched in EUR via a background TCGdex worker pipeline (`lootlink-tcgdex-worker`). - **EUR Native**: No USD conversions, FX rates, or American marketplace assumptions. - **7-Tier Condition Scale**: Native support for authentic European Cardmarket grading standards: 1. Mint (MT) 2. Near Mint (NM) 3. Excellent (EX) 4. Good (GD) 5. Light Played (LP) 6. Played (PL) 7. Poor (PO) - **Condition-Tied Valuations**: Portfolio and binder total values reflect assigned card conditions, not an optimistic NM default. ### 4. Print Languages & Variant Differentiation - **Language Autodetection**: On-device ML Kit OCR language classification + server trigram matching automatically detects print languages (`de`, `en`, `fr`, `it`, `es`, `jp`, `pt`). - **Variant Cataloging**: Base set, Holo, Reverse Holo, and Promo variants are tracked and valued separately. - **Human-Readable Badges**: Displayed using standard set and language notation (e.g. `PALde` for German Paldea Evolved). ### 5. Provenance Ledger & Instant QR Trading - **Append-Only Model**: Every card record includes an immutable origin log (`bought`, `gifted`, `traded`, `pulled`, purchase price in EUR, location, notes). - **Lineage Tree**: Gamified ownership transfer tree (`ProvenanceLineageTree`) tracking physical card provenance over time. - **1-Tap Transfers & QR Trades**: Instant card instance transfers between connected friends and QR code gift/trade handoffs on trade tables. ### 6. Social Friends, Trade Binders & Player Profile - **Social Friends Tab**: Dedicated Social tab for adding friends via invite links or QR codes, managing friend lists, and tracking trade partners. - **Trade Binder Web Sharing**: Generate read-only web share links for trade binders (`lootlink.app/share/`) allowing non-app users to view trade lists without authentication. - **Player Profile Shell**: Player Card screen featuring trainer identity, portfolio valuation statistics, showcase flex slots, and Trainer XP/level progression framework. ### 7. Privacy & Security - **Ad-Free**: Zero banner advertisements, popups, or ad network trackers. - **GDPR Compliant**: Self-service JSON data export (Art. 20) and full cloud account data purging. - **LootLink JWT Security**: Secure token authentication without third-party tracking scripts. --- ## Roadmap vs Non-Goals ### Active Roadmap (Planned / In Development) 1. **CSV Collection Import Engine**: Import existing collection files from TCGplayer, Collectr, Pokellector, or custom spreadsheets directly into LootLink's local SQLite database. 2. **AI Vision Grading Engine**: On-device centering ratio calculation and AI condition assistance (PSA-style 4-category grading). 3. **Full Trainer Avatar Forge**: Customizable trainer profile cards with Skia holo/rainbow shaders, 7 evolution stages, and gyro tilt effects (expanding the existing Player Profile shell). 4. **NFC Trade Share**: Bumping devices to share collection highlights or negotiate local trades. 5. **Trade Radar Push Notifications**: Automated push alerts when friends or nearby trade partners add cards to their wishlist that match your trade binder. 6. **Family Pass**: Parental consent and family account management under a fair freemium model. --- ## Canonical Links - Website: https://lootlink.app - Features: https://lootlink.app/en/features - Scanner & AI: https://lootlink.app/en/blog/how-scanner-works - Digital Binders: https://lootlink.app/en/blog/variants-and-languages - Offline Database: https://lootlink.app/en/blog/offline-first - EUR Pricing: https://lootlink.app/en/blog/eu-reality - Provenance Ledger: https://lootlink.app/en/blog/provenance-ledger - Privacy: https://lootlink.app/en/blog/privacy-and-local-ai - Roadmap: https://lootlink.app/en/blog/active-roadmap-2026 - Player Profile & QR Trade: https://lootlink.app/en/blog/player-profile-qr-trade - FAQ: https://lootlink.app/en/faq - Blog / Guides: https://lootlink.app/en/blog