# PlayKami

> PlayKami is a gamified collectibles marketplace where users buy digital trading card packs, reveal randomized cards, trade with other users, and redeem physical items shipped worldwide.

## How It Works

Users buy packs containing randomized collectible cards (Pokemon, One Piece, and more). Each card is backed by a real, authenticated physical item. After opening a pack, users can keep the card in their digital collection, list it for sale on the marketplace, trade it with others, sell it back instantly at 90% value, or redeem it to have the physical item shipped to their door.

## Rarity System

Cards come in six rarity tiers: Common, Uncommon, Rare, Epic, Legendary, and Mythic. Rarity affects card value and pull odds. Odds are locked at the time of purchase and verified through an open-source fairness verifier.

## Pages

### Home (`/`)
The landing page introduces PlayKami with a rotating hero carousel, quick-action buttons linking to pack categories, and sections highlighting the platform's value: 0% marketplace fees, 90% instant buyback, and real physical ownership. Shows an app experience video and download links for the mobile app.

### Capsules — Shop (`/capsules`)
The main shop where users browse and buy packs. Features a vending machine display, pack selection carousel with prices, and category filters by franchise. Shows rarity odds, expected value, and possible rewards for each pack. Users can buy with wallet (USDC), credit card, or earned points. Supports promo codes for discounts and a demo mode to try without spending.

### Pack Reveal (modal after purchase)
An animated reveal experience with video, sound effects, and particle animations. Cards are revealed one at a time with rarity-based styling. After the reveal, users choose what to do with each card: keep it, trade it, redeem it physically, or accept a 90% buyback offer.

### Marketplace (`/marketplace`)
A peer-to-peer trading venue where users browse cards listed for sale by others. Features filtering by franchise, sorting by price or date, and search by card name. All trades have 0% fees. Each listing shows the card image, name, and price in USDC.

### Card Detail (`/card/[id]`)
A detailed view of an individual card showing its image, name, rarity, category, and grading info for slabbed cards. Displays the complete trading history with previous owners and sale prices. Users can buy the card if listed, make offers, list their own cards for sale, or accept a buyback offer if eligible.

### Profile (`/profile`)
The user's central hub with an editable profile picture, username, wallet address, account level, and collectible count. Organized into tabs:
- **Collection** — all owned cards in a searchable, filterable grid
- **Favorites** — cards saved from the marketplace
- **Activities** — purchase and trade history with dates and prices
- **Offers** — incoming offers from other users and outgoing offers made, with accept/reject/cancel actions
- **Listings** — cards currently listed for sale with asking prices

Other users' profiles can be viewed at `/profile/[address]` showing their collection and trade history.

### Redeem (`/redeem`)
A multi-step flow to convert digital cards into physical shipments. Users select cards from their collection, enter a shipping address, choose a shipping method, review the order with shipping costs, and confirm. Supports worldwide shipping to eligible countries.

### Redemption Tracking (`/redemptions/[id]`)
Tracks the status of a physical redemption order through stages: preparing, shipped, and delivered. Shows shipping address, courier details, and a list of items in the shipment. Includes a "Track Now" button linking to the carrier's tracking page and a support contact option.

### Referrals (`/referrals`)
Users copy and share a personal referral link. The page shows a list of referred friends, how many packs each friend has bought, and the total points earned from each referral. Referrers earn bonus points for every pack their friends purchase.

### Leaderboard (`/leaderboard`)
Ranks users competitively across two categories: Level (XP-based) and Referrals (friends invited). The top 3 users are highlighted with special styling. Shows the current user's rank and an infinite-scroll list of all ranked users below the podium.

### Settings (`/settings`)
Account management where users edit their profile picture and username, view their wallet address and email, check their USDC and MON balances, and deposit or withdraw funds.

### FAQ (`/faq`)
Expandable Q&A sections covering how PlayKami works, pack odds and fairness verification, item authenticity and grading, shipping and redemptions, payment methods, buybacks, and marketplace mechanics.

### Documentation (`/documentation`)
Technical documentation and API references for developers building on the PlayKami ecosystem.

### Contact Us (`/contact-us`)
Support page with an email link to contact@playkami.io and social media links to Twitter/X, Instagram, and TikTok.

### Privacy Policy (`/privacy-policy`) and Terms of Service (`/tos`)
Legal pages covering data handling and usage terms.

## Payment Methods

- **Wallet** — USDC stablecoin on the Monad blockchain (gas fees sponsored by PlayKami)
- **Credit Card** — via Coinflow payment processor
- **Points** — earned through app activity, referrals, and daily engagement

## Key Features

- **0% Marketplace Fees** — no commission on peer-to-peer trades
- **90% Instant Buyback** — sell any card back within 7 days at 90% of market value
- **Physical Redemption** — ship authenticated physical cards worldwide
- **Verified Authenticity** — all items are genuine with PSA/BGS grading certificates for slabbed cards
- **Provably Fair** — odds verified through an open-source verifier at verifier.playkami.io
- **Referral Rewards** — earn points for every pack referred friends purchase
- **XP & Leveling** — earn experience and climb the leaderboard through activity
- **Cross-Chain Support** — operates on Monad, Base, and BSC networks with built-in bridging