Deck Builder and Checkout

Deck Builder & Physical Card Checkout

Managing constructed decks across multiple binders and storage boxes is often cumbersome. Bindarr solves this by integrating a digital Deck Builder directly with a Physical Card Checkout & Return Locator.

---

Building & Analyzing Decks

In the Decks tab, you can construct and analyze decks for Pokémon (Standard, Expanded, Unlimited) or Magic: The Gathering (Commander, Modern, Standard, Vintage, Legacy).

• Card Availability Tracking: As you add cards to a deck list, Bindarr displays how many physical copies you own in your collection versus how many are already committed to other active decks.
• Cross-Language 4-Copy Rule: The deck builder enforces maximum card limits based on the card's canonical English name, regardless of which language printing you add.
• Deck Analytics: View real-time visual charts for mana/energy curve, type distribution (Creatures/Spells/Lands, Pokémon/Trainers/Energy), and rarity breakdown.
• Draw Simulator / Hand Tester: Test opening 7-card hands and simulate sequential turn draws with built-in shuffling.

---

The Physical Checkout Workflow

When you want to assemble a deck to take to a tournament or game night, you Check Out the deck:

[Digital Deck List]
        │
        ▼ (Click "Check Out")
┌─────────────────────────────────────────────────────────────┐
│ 1. Availability Check: Confirms copies aren't double-booked │
│ 2. Lock Reservation: Sets deck.checked_out = true           │
│ 3. Locator Wizard: Generates physical shelf-picking guide   │
└─────────────────────────────────────────────────────────────┘
        │
        ▼ (Physical Cards in Play)
[Storage Grids display "In Play" badges; positions preserved]

Key Principle: Storage Positions Never Move

Checking out a card does not remove or shift its database position in your binders or boxes. The card's stored binder, page, and pocket number remain identical. The database merely marks the copy as locked/checked-out.

---

The Checkout Locator Wizard

Clicking Check Out opens the interactive Checkout Locator Modal (GET /api/decks/:id/locations):

1. Grouped by Physical Container: The checklist organizes needed cards by container (e.g. Binder 1: Modern Staples), then by page number, then by pocket slot (1–9).
2. Visual Page Highlights: When you open a container in the locator, the exact grid pockets containing your deck's cards are highlighted with pulsing badges.
3. Missing Card Summary: If your deck calls for 4 copies of a card but you only own 3, the wizard flags the missing copy so you can acquire or proxy it.
4. Checklist Selection: Check off cards as you pull them from your physical binders into your deck box.

---

"In Play" Status in Collection & Binders

While a deck is checked out:

• Any physical card copies allocated to the deck display an "In Play" badge in the Collection view and Binder grids.
• In-play cards are visually dimmed to remind you that the physical pocket is temporarily empty.
• Other decks cannot check out those same copies until the active deck is checked back in.

---

Deck Check-In & Return

When you return home from your game night:

1. Navigate to Decks and select your checked-out deck.
2. Click Return Deck.
3. The Return Locator Wizard opens in reverse (mode="checkin").
4. The wizard presents a step-by-step checklist of where each card belongs:
   • Example: Put Lightning Bolt into Binder "Red Spells", Page 3, Slot 4.
5. As you return each card to its designated binder pocket, check it off the list.
6. Confirm return to clear the "In Play" badges across your collection.