Adding cards
The fast paths for entering a single card, a stack of slabs, or a spreadsheet — and the keyboard shortcuts that make a 50-card session feel like five minutes.
Three ways to add
- Type it in — /binder/add. Single card at a time. Best for raw cards, custom inserts, or anything you don’t have a cert for. Sticky template carries year / brand / set / parallel / sport / grade across the loop so you only re-enter the unique fields.
- Cert lookup — /binder/add?mode=slab. Paste a PSA cert; we pull grade, player, year, set, card # from the grader. Edit the preview, save. PSA today; BGS / SGC / CGC queued. Needs a PSA token in Personal APIs.
- Import file — /binder/add?mode=import. Upload a CSV / XLSX from Card Ladder, Collectr, Beckett, PSA export, Cardstock, TCDB, MarketMakers, or your own sheet. Auto-detects the format, shows a preview, commits atomically with rollback. See Import troubleshooting.
Power-user keyboard shortcuts
| Shortcut | Where | What it does |
|---|---|---|
| Enter | Cert input (slab mode) | Look up the cert |
| Cmd / Ctrl + Enter | Anywhere in slab mode | Lookup if no preview, otherwise Save & next slab |
| Cmd / Ctrl + Enter | Anywhere in manual form | Save & add another (sticky fields preserved) |
| Tab | Throughout | Standard field navigation — auto-focus on the next slab's cert / next card's player after a continue-save |
The continue-add loop
Both manual and slab forms have two save buttons: Save card (terminal — pushes you to the card detail page) and Save & add another / Save & next slab (continues the loop on the add page).
A typical slab pack of 10 PSA cards looks like this:
- Paste cert →
Enter - Glance at the preview, fix anything that looks off
- Optionally enter a purchase date / price / source (these stay preserved across the next nine cards)
Cmd / Ctrl + Enter→ save and jump to the cert input for the next card- Repeat 9× more
A ✓ Saved banner pops at the top of the form after each save — auto-dismisses in 4 seconds, stays visible long enough to grab the View / Edit links if you spotted something to tweak.
What gets carried over, what gets cleared
| Field | Manual continue | Slab continue |
|---|---|---|
| Year | kept | (from cert) |
| Brand / Set / Parallel | kept | (from cert) |
| Sport / Team | kept | (from cert) |
| Grade / Grading company | kept | (from cert) |
| Status / Storage / Source | kept | kept |
| Acquired date / price | kept | kept |
| Players | cleared | (from cert) |
| Card number / Serial / Cert # | cleared | cleared |
| Current value (USD) | cleared | cleared |
| Notes | cleared | cleared |
Manual sticky template lives in your browser’s localStorage so it survives a full reload. Click Clear and start fresh in the gold banner at the top of the form to wipe it whenever you shift to a different set or grader.
The This-session list
The strip at the top of /binder/add shows the last 5 cards you added in the current tab session — kind chip (Slab / Raw), player label, relative time, and View / Edit links.
- Survives mode switches. Flipping between Type / Cert / Import keeps the list in place.
- Survives full reloads(sessionStorage), but a fresh tab starts empty — that’s deliberate, the list represents this session, not a permanent activity log.
- Capped at 5; the oldest drops off as you add. Use Clear list to wipe manually.
- Useful for spot-checking.Mid-batch you can confirm you didn’t skip a cert or accidentally enter the same one twice.
Card images: front + back
After you save a card, open it from the binder list (or the View link in the toast) and click Edit. The Card images panel has two slots — Front and Back — both free for any tier.
- Click, drop, or paste. Phone photos work great. We compress to ~400 KB (max 500 KB), resize the long edge to 1800 px, convert to WebP, strip EXIF metadata. All on your device before upload.
- Replace anytime. Uploading a new front (or back) soft-deletes the prior one of the same kind. The other slot is untouched.
- HEIC photos. Not supported yet. iPhone: Settings → Camera → Formats → Most Compatible.
Card detail: hover or tap to flip
On the card detail page, the hero image flips to the back when you hover (desktop) or tap (touch). Falls back to a static front when no back image is uploaded — the flip affordance only appears with something to flip to. A small Hover for back hint is in the corner so the gesture is discoverable.
Both images are preloaded so the swap is instant; the back is aligned with object-containso a back photographed in landscape won’t crop.
When something doesn't save
- “permission denied for function …”— shouldn’t happen as of mig 051; if it does, capture the exact message and ping the team. The trigger pipeline depends on EXECUTE grants on the lamport helper.
- “Cert already exists” — slab certs are unique per user. Search your binder for the cert # to find the existing card.
- “Player name is required” — the player textarea on the manual form (or the player input on the slab preview) needs at least one non-empty entry. Multi-player cards are newline-separated on the manual form, comma- or slash-separated on the slab preview.
- PSA lookup fails with “missing token” — the cert lookup uses your PSA Public API token. Add it in Settings → Personal APIs; PSA gives 100 free calls / day per token.