Features & guides
This page summarizes the in-repo FEATURES.md guide for beta testers, support, and teams. LootScout is a mobile app (React Native / Expo) focused on the Raleigh–Durham, NC area, with hybrid pricing (JustTCG, catalog baselines, and local transaction intelligence over time). Some capabilities require a development build, not Expo Go — especially the card scanner.
Canonical source: FEATURES.md in the website repo. Scanner implementation notes may also live in app-repo docs such as docs/features-card-scanner.md.
1. Account & basics
Sign up and sign in with email (Supabase Auth). Confirm email if your project requires it.
Typical tabs: Home, Collection, Profile, plus beta routes your build exposes (e.g. Scanner, Shop, Pickup). Pull to refresh on supported screens reloads server-backed data.
2. Home tab
Portfolio shows collection value and gain/loss (scope may follow folder filters). Pull to refresh updates figures.
Product search: While typing, search is database / catalog only — fast, without live TCG API on every keystroke. When you submit (Search / Enter), the app runs a hybrid search path that may call external APIs when appropriate, then merges and caches results.
Listings search: Switch to listings mode when available; use filters (price, condition, distance, etc.). Distance may require location permission.
See also: FAQ — external APIs while typing.
3. Product page
Open from search or scanner match. Choose RAW vs GRADED (trading cards) or category-specific condition UI.
Add to collection opens the add sheet with prefilled catalog data; pick condition, variant, folder, optional purchase price, then save. If you already own the item, quantity and sell flows apply as offered.
4. Collection
Add from Collection → Add: image lookup where supported, search by name, condition (including graded options), optional purchase price and folder, then save.
Recent builds polish add-to-collection from scanner and product flows, including safe-area and scroll behavior so primary actions stay clear of the home indicator.
CSV import (when enabled): bring an existing spreadsheet from another tool — you don't have to re-enter your whole collection. Map columns, preview matching, confirm bulk import, resolve duplicates per app messaging.
List for sale from a collection item — listing is prefilled from condition, variant, and catalog links; fixed price vs offer-only where supported.
5. Card scanner (TCG)
Requires a physical iOS or Android device with a dev client or store build that includes camera + on-device OCR. Web builds show a scanner-unavailable style message. Read build requirements →
Single mode: Point the camera at a card; when a match is found, a sheet shows the best match and alternates. Open a full match list or manual catalog search. Manual search uses catalog-first typing; broader API search only after explicit Search / Enter, and only if the catalog returned no rows.
Batch mode: Scan in sequence; thumbnails appear along the bottom with remove controls; Review is placed so it does not overlap thumbnails. The scanner pauses while pickers and sheets are open. On the batch review screen, set condition (including graded grades), variant, folder, see approximate prices per row where data exists, change match from the thumbnail, remove rows, then add all to collection.
Cost: Scanning is free for every account during beta — no separate scanner fee.
6. Listings & selling
Create listings from collection or listing flows. Fixed vs offer types; auto_price may track catalog prices until you manually override (see product docs).
Record sale / sale confirmation flows apply for in-person deals where implemented.
7. Shops, trades & pickup
Shop-scoped pickup cart on device; Pickup hub and checkout routes; kiosk tablet flow with QR listings; trade/sale drafts from listing QR where enabled. See kiosk/pickup documentation in the app repo for routes and deep links.
8. Profile & subscription
Profile shows public info, shop entry points, usage, and settings. Subscription billing may open the Stripe customer portal from Edge Functions. Usage limits refresh on focus in supported builds.
9. AI & analytics (where enabled)
Price trend hints, market opportunities, portfolio analytics — availability depends on build and configuration.