Documentation

Cards that unlock music

Slappcard prints physical NFC/QR cards that open a private listening page for one artist. No public storefront, no algorithm — a fan taps or scans, enters an email, and the music unlocks.

Read the fan guide Try the live app →

How it connects

1. Artist uploads music and orders a pack.
2. Slappcard mints a unique code per card, prints QR (and NFC on Boss), and ships the pack.
3. Fan taps or scans → staging.slappcard.com/c/\{code\} → email (or sign-in) unlocks a private player.
4. Artist gets the email and the stream. Affiliate (if one referred the artist) earns on the first pack.

For fans

Fan guide

Tap, scan, unlock, listen, and get help if a card is lost.

For artists

Artist guide

Set up your workspace, upload music, order cards, read your numbers.

For connectors

Affiliate guide

How referral tracking, commissions, and payouts work.

For labels

Label guide

Roster check-in for invited label staff — counts, not fan emails.

For developers

Quickstart

Clone, install, and run Slappcard locally (Next.js + Convex).

Links

Live app	staging.slappcard.com
Development	development.slappcard.com
Try a card	/c/welcome-intro
Source	github.com/JamesFincher/Slappcard
Support	slapcardz@gmail.com

---

Team / ops

Admin runbook, architecture, Convex API, and deploy notes. Same private repo — not credentials.

Team

Internal docs →

How it works, architecture, data model, admin runbook, deployment.

Ops

Admin guide

Mint batches, onboard artists, orders, abuse, support.

Engineering

How it works

Fan / artist / affiliate topology, access modes, legacy cards.