SwiftSale Complete Feature Guide

What is created

• An active show ID based on the current timestamp.
• A show name, started timestamp, and show status for local analytics.
• A backend show code from the show-session API.
• A Companion join URL and QR target using that show code.

What sellers see

• Capture view shows the show code, QR code, and Companion join link.
• Mission Control shows timer, total assignments, unique buyers, repeat buyers, pace, and activity charts.
• Analytics can be viewed as cumulative or per-minute buckets.
• Ending a show records an ended timestamp for analytics status.

Capture methods

Enter a username manually or use the clipboard watcher that polls copied text, extracts handles, and ignores Companion join URLs.

Duplicate protection

The capture service keeps a short recent-capture window so the same username copied repeatedly within about one second returns the existing row instead of creating a new rapid duplicate.

Winner records

Captured rows are stored in the local winners database with username, BIN, and created timestamp. The winner list can be cleared, individual rows deleted, and winner CSV data exported.

Live BIN board

• Capture view shows current assignments and grouped winner history.
• The BIN board displays occupied BINs within the active bin limit.
• Double-clicking a buyer or BIN card copies the username for chat use.
• Removing a BIN assignment clears the buyer from that BIN.

Limits and repeat buyers

• The current BIN limit is read from entitlement data.
• When the limit is reached, SwiftSale surfaces a BIN_LIMIT_REACHED error.
• Repeat buyers keep their existing BIN instead of consuming a new one.
• Clearing winners resets the local BIN map and related game state.

Join flow

Capture view builds a Companion join link and QR code. The Companion join page reads the code from the URL, validates it with the backend, and joins the show socket room.

Live assignment sync

When SwiftSale records an assignment, the backend emits assignment_created and bin_assigned events. Companion displays the latest assignment and a live BIN feed.

Companion upload

The Companion join page includes an Annotate Packing Slips upload. It sends a PDF and show code to the backend, then downloads an annotated PDF when matching succeeds.

Input and matching

• Select a Whatnot packing slip PDF.
• SwiftSale extracts page text and looks for usernames on packing slip pages.
• Matching uses the current winners database and compatible buyer/BIN tables.
• Giveaway pages can be stamped GIVEAWAY when giveaway language is detected.

Stamp placement

• Shipping Center can render the first PDF page for placement preview.
• The seller can drag the stamp position before annotation.
• Saved placement coordinates are reused for future annotations.
• The stamp is clamped to stay inside the page bounds.

Output behavior

• The output is a new annotated PDF.
• Matching slips receive the SwiftSale BIN stamp.
• Duplicate buyer labels can produce summary pages.
• Compatible packing-slip address data can be captured into the mailing list.

Tracked profile fields

• Display username and normalized username.
• Total purchases.
• First purchase and last purchase timestamps.
• Last BIN when the buyer has a paid BIN assignment.
• Current-show purchase count where available.

Buyer History view

• Summary cards for total buyers, purchases, repeat buyers, and current-show activity.
• Buyer directory with search and repeat-only filtering.
• Sort options for recent activity and purchase count.
• Profile drawer with the buyer's totals and last BIN.

Buyers CSV import

SwiftSale imports CSV files with recognized username and BIN columns, normalizes rows, dedupes repeated username/BIN pairs in the import, and adds them to the winners database.

Winners CSV export

SwiftSale exports winner records to CSV with username, BIN, and created timestamp, using a file picker output flow.

PDF output flows

Shipping Center generates annotated packing slip PDFs and selected mailing-list label PDFs. The Mission Control packing-list button was not documented here because its handler is a placeholder.

Captured fields

The mailing list stores full name, username, email, street address lines, city, state, ZIP code, order date, order ID, order count, spent amount, checked status, and timestamps.

Review and select

The table supports refresh, row checkboxes, select-all, selected count, and deletion of selected mailing-list records.

Export labels

Checked mailing-list entries can be exported to a mailing-label PDF. The app asks for an output PDF path and can open the result for printing.

Bingo

• Captured winners can be assigned Bingo labels on a 5x5 board.
• Default config includes line bingo, auto-start after 20 qualified wins, assigned-number draw preference, and forced valid winner finish.
• Giveaways are ignored by default unless configured otherwise.
• The seller can start, auto draw, reset, enter a prize, copy game chat lines, and see near-winner alerts.
• Companion displays the Bingo board, called numbers, players, near alerts, winner overlay, and prize when present.

Bin Bonanza

• Loads BIN entries from the active show winners data.
• Wheel mode supports up to 50 entries in the seller UI.
• The seller can set a prize name, start the wheel, draw a random winning BIN, and reset.
• Companion displays the wheel state, prize, entries, winner reveal, and recent winners.

Prize Vault

• Calculates top-buyer standings from captured winners for the active show.
• The seller enters 20 case prizes and starts a finale reveal sequence.
• The UI reveals third place, second place, top buyer, then lets the top buyer choose a case.
• Companion receives Prize Vault display updates for leaderboard stages, selected case, and revealed prize state.

Vault Breaker

• Uses a 3-digit secret code that can be generated or manually set on desktop.
• Top buyers are pulled from captured winners when available.
• The seller controls prize, start, digit guesses, manual open, push display, and reset.
• Companion shows locked digits only, current picker, top buyers, guess state, and winner overlay when opened.

Access and BIN limits

The app refreshes entitlement data from the backend, applies the returned BIN limit, and lets users redeem an access code to unlock a higher limit for the install.

Admin access codes

The hidden admin view supports admin login, listing codes, creating codes with labels, BIN limits, and 30/60/90 day durations, plus disabling codes.

Updates

The updater checks for updates, auto-downloads available releases outside development mode, shows download progress, and offers a restart-to-update action after download.