← Nerdworks

Nerdworks Singles — Module Project Brief

PBNW4 Brief Nerdworks

Module overview

The Nerdworks Singles vertical is a dedicated TCG card singles section — sale-or-return consignment, outright buy, trade-in, and bulk-lot acquisition. All cards appear as Nerdworks stock publicly; seller identity is never shown. Pokémon and MTG at launch.

Acquisition channels

ChannelNotes
Consignment (sale-or-return)Seller sets minimum acceptable price. Paid on sale minus commission. Primary launch channel.
BuyNerdworks buys cards outright — cash or store credit.
TradeStore-credit swap — seller brings cards, walks out with credit.
Bulk-lotNerdworks buys whole collections (inherited, house-clearance, dealer stock).

Locked decisions

AreaDecision
TCGs at launchPokémon + MTG only
Card data APIsScryfall (MTG, free) + pokemontcg.io (Pokémon, free) — pre-scan bulk dump at activation; weekly cron for new sets
PricingCardmarket primary (UK/EU), Pricecharting secondary; averaged. TCGplayer reference only (US/USD skew — not averaged).
Product model1 card : 1 SKU — each physical card is its own WC product, stock 1
Condition gradesNM + LP only. Staff-verified at intake, not customer self-report.
Seller identityAnonymous. Nerdworks branded. No “sold by X” on product pages.
FulfilmentNerdworks holds stock and ships after sale
PayoutsCustom processor reusing AffiliateWP PayPal + Stripe Bank Transfer gateway classes (gateway only — NOT the referral/commission data model)
Intake locationIn-store on iPad at store.nerdworks.uk
Identity verificationStripe Identity — required before account creation on first intake
Ownership proofSigned declaration + Stripe Identity photo ID + staff discretion + cross-reference against stolen-card registers. No receipts required.
My Consignments dashboardIn scope for launch

Data model

The card catalogue layer is separate from WooCommerce products. Canonical card records live in a dedicated custom table (camcom-singles plugin), populated by API pre-scan. Every Pokémon and MTG card in existence has a catalogue record regardless of Nerdworks stock levels. WooCommerce products reference a catalogue card ID. Canonical card profile pages always exist — the “available now” section pulls live SKUs. Price history stored against catalogue card, not per-SKU.

Surface inventory

CategorySurfaceNotes
HubSingles service landing (/singles/)Top-level IA anchor
ServiceSell your cardsHow-it-works template
ServiceConsign your cardsHow-it-works template
ServiceTrade-inHow-it-works template
ServiceBulk-lot salesHow-it-works template
ReusableHow-it-works templateCross-site reusable
ReusableTrust/credentials templateCross-site reusable
ReusableFAQ component packACF Gutenberg block
PPCSale-or-return PPC landingStep 12 static build done; step 13 next
PPCBuy PPC landingReuses PPC template
PPCTrade-in PPC landingReuses PPC template
CatalogueCanonical card profile pageAlways exists per card; lore/history/price chart/available-now
CatalogueSet pagesBrowse all cards in a set
CatalogueArtist spotlight pagesBrowse by illustrator (strong MTG SEO)
MarketBiggest gainers/losers (weekly)Engagement + SEO
MarketTop 100 most valuable in stock
MarketNew arrivals
MarketSet trackersWhole-set index performance
CommerceSingles archive (browse + filter)Search-first UX; large product count
CommerceIndividual product pageBuy button, condition, price, shipping
CommunityPull of the weekStore-sourced content
CommunityCard of the dayHomepage module + archive
CommunityDeck tech pagesFeatured decks, auto-linked to stock
CommunityBlog/newsSet reviews, meta reports, buying guides
AccountMy Consignments dashboardSeller tracks cards + payouts
AccountCollection tracker“I own these cards” — live value
AccountPrice alertsNotify when card drops below £Y
AccountComplete-the-set toolMissing-cards shopping list
IntakeIn-store iPad micro-siteChromeless, touch-first; store.nerdworks.uk

Backend plugin — camcom-singles

Design direction

Inherits SNW1 Showcase Dark styleguide (post 11409). Three-colour section rhythm (dark → light → green). Card artwork is the primary visual element. JetBrains Mono for prices and condition grades. Both Pokémon and MTG must look equally at home — test every layout with a reference card from each game. Use real card data from Scryfall + pokemontcg.io APIs for content realism in mockups and prototypes.