Frequently Asked Questions

FAQ

🚀 Getting Started

🎯 How Does This Work?

Township Cards is your automatic trading partner finder for Playrix Township card collections. Here's how it works:

  1. 1
    Set Up & Maintain Your Inventory: Mark which cards you have (and how many) and which cards you need. Keep it updated as you get new cards! The more accurate your inventory, the better matches you'll get.
  2. 2
    We Find Matches Automatically: Our matching engine searches through all players and finds people who have cards you need AND need cards you have. No more scrolling Reddit or Discord!
  3. 3
    Connect & Trade: Copy their friend code, add them in Township, and coordinate the trade. You can even mark trades as complete right here to keep track!
  4. 4
    Stay Updated: Get daily email notifications when new matches appear, and track your trading history with friends!

The best part? It's completely free, has no ads, and works automatically in the background. Set up your inventory, keep it updated as you get new cards, and we'll keep finding you new trading partners as the community grows! Both givers and receivers can now update their inventory automatically when trades are confirmed!

Why am I being asked to complete my profile?

To access features like My Collection, Matches, Friends, Trades, and Messages, you need to complete your profile with your Game Name and Friend Code. This helps other players identify you when trading and ensures everyone can connect properly in Township.

If you see a message saying "Please complete your profile with your game name and friend code to access this feature," simply click the link to go to your profile page and fill in those fields. Once done, all features unlock automatically!

Why do I need to verify my email to send friend requests or messages?

Email verification is required for outbound social actions—sending friend requests, creating trades, and sending messages. This protects our community from spam and helps ensure interactions come from real accounts.

Good news: You can still receive and respond to friend requests, confirm trades sent to you, and read messages—all without email verification. Verification is only required when you're the one initiating the action.

To verify your email, check your inbox for the verification email we sent when you signed up. Click the link to verify instantly. If you can't find it, you can request a new verification email from your profile page.

Can I view profiles and leaderboards without completing my profile?

Yes! You can browse other players' public profiles and view leaderboards even if you haven't completed your own profile yet. This lets you explore the community and see what's possible before committing to setting up your trading profile.

What is the timezone setting for?

Setting your timezone makes all dates and times appear in your local time! Instead of seeing confusing UTC times, you'll see when messages were sent, when trades happened, and when users joined—all in your own timezone.

We'll try to detect your timezone automatically from your browser. If we can't, we'll default to UTC and show a reminder banner asking you to set it. You can always change your timezone in your profile settings.

Bonus feature: When both you and another player have set your timezones, you'll see a time offset indicator (like "+3h" or "-5h") showing how many hours ahead or behind they are. This helps when coordinating trades across different time zones!

📝 Inventory Management

Do I need to update my inventory after trading?

It's easier now! When you mark a trade complete, you'll see a "Still have more?" prompt asking if you still have extras of the card you just gave. Simply click "Yes, I have more" or "No, that was my last" and your inventory updates automatically.

The prompt is smart—it pre-selects the most likely answer based on how many you had. If you had 3 copies and gave one, "Yes, I have more" will be highlighted. If you only had 1, "No, that was my last" will be highlighted.

For cards you receive: After confirming you received a card, you'll see a prompt asking if you want to add it to your inventory. Simply click "Yes, add to inventory" and your inventory updates automatically! If you prefer to update manually later, click "No, I'll update later" and you can adjust your inventory from the Inventory page anytime.

What happens if I make a mistake on the "Still have more?" prompt?

If you accidentally clicked the wrong option, you can cancel the trade (if the recipient hasn't confirmed yet) and your inventory will be restored. Then mark the trade complete again and choose the correct option.

Alternatively, you can always manually adjust your inventory from the Inventory page at any time.

How do I know when I've completed a collection?

When you own at least one copy of every card in the active collection, you'll see a celebration modal with confetti animation! The system automatically detects completion when you view your inventory page.

After dismissing the celebration, you'll see a "Collection Complete!" badge at the top of your inventory page showing which completion round you're on (1st, 2nd, 3rd, etc.). Your progress bar will also turn amber/gold to indicate completion.

You'll also receive a congratulatory email celebrating your achievement! The email includes your completion round number and a link to view your collection.

What happens after I complete a collection?

When you complete a collection, the system records your completion and shows you a celebration. Your completion is tracked with a round number (1st completion, 2nd completion, etc.).

Start a new round: After completing a collection, you'll see a "🔄 Start New Round" button in the completion badge. Click it to reset all your cards to 0 and start collecting again! This matches the in-game behavior where collections repeat.

Your matches will continue to work normally—you can still trade cards even after completing the collection!

How do I reset my collection and start a new round?

After completing a collection, you'll see a "🔄 Start New Round" button in the completion badge at the top of your inventory page. Click it to see a confirmation modal that shows:

  • The next round number (e.g., "Round 2")
  • A warning that all your cards will be reset to 0
  • Confirmation that your previous completion records are preserved

Click "Reset & Start Fresh" to confirm, or "Cancel" to keep your current progress. Once reset, you'll start with 0 cards and can begin collecting again. You'll receive an email notification confirming the reset and encouraging you to start collecting!

Note: You can only reset if you've completed the collection. The reset button only appears when you have a completion record and currently own all cards in the collection.

What happens to my previous completion when I reset?

Your previous completion records are permanently preserved! When you reset, only your card quantities are set to 0—your completion history remains intact. This means:

  • All your previous completion records (Round 1, Round 2, etc.) are kept
  • The round number shown on your inventory page is calculated from your completion history
  • Future features like completion badges will use this historical data

When you complete the collection again, a new completion record will be created for the next round automatically.

Can I reset a collection that has ended?

No, you cannot reset collections that have ended. The reset button only appears for active collections. Once a collection ends, it becomes read-only and you cannot modify your inventory or reset it.

If you try to reset an ended collection, you'll see an error message. This prevents accidental resets and preserves historical data for completed collections.

What happens when a new collection is released?

When Playrix releases a new card collection in Township, we update our system with the new collection data. Here's what happens:

  • The new collection becomes active — You'll see the new cards on your inventory page
  • Your old collection data is preserved — All your cards, trades, and completion records from the previous collection remain in the system
  • Matches update automatically — The system recalculates matches based on the new collection

Important: Your inventory for the old collection is NOT deleted. When archive views are added in a future update, you'll be able to browse your historical data.

Will I lose my cards when a new collection starts?

No! Your card inventory from previous collections is permanently preserved. When a new collection launches:

  • All your UserCard records (what cards you owned and how many) remain in the database
  • Your completion records stay intact (if you completed the collection)
  • Your trading history with partners is preserved

The old collection simply becomes inactive, and the new collection takes over as the active one. This mirrors how Township handles collection seasons.

Do I need to do anything special to get the completion celebration?

No! The system automatically detects completion when you view your inventory page. Just make sure you've marked all cards as owned (quantity ≥ 1) in your inventory. The celebration will appear automatically the next time you visit the inventory page after completing your collection.

If you complete your collection but don't see the celebration right away, try refreshing the inventory page. The detection happens in real-time when you load the page.

🔍 Finding & Understanding Matches

How do I find trading partners?

After you add your card inventory (marking which cards you have and which you need), our matching engine automatically finds other players who are compatible traders. Visit the Matches page to see all your potential trading partners!

What are mutual vs one-way matches?

Mutual matches mean both you and another player can help each other. You have cards they need AND they have cards you need. These are ideal for trading!

One-way matches mean only one direction works. Either you can give them cards they need, OR they can give you cards you need (but not both). You can still trade with one-way matches. It just means you'll need to find other partners for the reverse direction.

How do I filter my matches?

At the top of the matches page, you'll see filter buttons that let you narrow down your trading partners:

  • All: Show all matches (default)
  • Mutual: Show only partners where you can trade both directions
  • I Give: Show partners where you have cards they need (one-way)
  • I Receive: Show partners who have cards you need (one-way)
  • All Stars: Show matches for all card rarities
  • 3+ Stars: Show only matches involving 3, 4, or 5 star cards
  • Any TZ / Same TZ / Within 2h / Within 4h: Filter partners by timezone proximity (requires a saved timezone)

Combine filters: You can use both type and star filters together! For example, select "Mutual" and "3+ Stars" to see only mutual trading partners for high-value cards.

Timezone filters: If you've set your timezone in your profile, you can filter to partners in the same zone or within 2–4 hours of your time.

Filters are preserved in the URL, so you can bookmark filtered views or share links with specific filters applied.

What do the match card indicators mean?

The Matches page includes a quick legend that explains card tile indicators like New (recent matches) and Pending (a trade or agreement already in progress).

If you see a Pending tile, it means either a trade is awaiting confirmation or a trade agreement is awaiting a response. It’s a helpful way to avoid starting duplicate trades.

What if I don't see any matches?

If you don't see any matches on the Matches page, the page will show helpful information based on your situation:

  • No inventory yet: You'll see a prompt to set up your inventory first
  • Inventory but no matches: You'll see an encouraging message that matches will appear as more players join, along with a summary of your available cards
  • Unverified email: You'll see a reminder to verify your email to receive match notifications

The matching system works automatically - just make sure your inventory is up to date and verified users will be able to find you!

Can I filter matches to a specific friend?

Yes! You can filter the Matches page to show only matches with a specific friend. There are two ways to do this:

  • From the Friends Hub: Click "Find trading opportunities" on any friend card to go directly to matches filtered to that friend
  • Direct URL: Add ?friend_id=123 to the matches URL to filter to a specific friend

When filtering by friend, you'll see a green banner at the top showing "Showing matches with @FriendName" with a "Show All" link to clear the filter. All your existing type and star filters still work when combined with the friend filter!

How do I quickly find trading opportunities with a friend?

Go to the Friends Hub and find the friend you want to trade with. On their friend card, you'll see either:

  • Trade summary: If you've traded before, you'll see stats like "3 given ¡ 2 received" with a link to "View Trade History"
  • "Find trading opportunities": If you haven't traded yet, click this link to jump to Matches filtered to just that friend

This makes it easy to focus on one friend at a time—perfect when you're coordinating a specific trade in Township!

🤝 Trading & Trade Tracking

How do I trade cards?

When you find a match, copy their friend code and add them in Township. Then coordinate the trade in-game! This tool helps you find partners. The actual trading happens in Township itself.

What are Trade Preferences?

Trade Preferences let you tell other players your trading style. You can set them in your Profile Settings:

  • Mutual Only: You only accept trades where both sides exchange cards
  • Equal Value: You prefer trading cards of the same star value
  • Generous Trader: You're happy to give higher-value cards without expecting equal value back
  • Star Range: Specify which star levels you're interested in trading (e.g., only 3-5★ cards)

These preferences show as badges on your profile and when others view you. They're informational only—helping you coordinate trades, not restricting what you can do.

What is Daily Send tracking?

Township allows 3 card sends per day during collection events. Daily Send tracking lets you keep track of how many sends you have left without leaving the app.

Enable tracking in your Profile Settings, then use the quick controls on the Matches page to log sends and reset at the start of each day. Your remaining sends (e.g., "2/3") show on your profile and in match views.

Can I see other players' trade preferences?

Yes! When viewing another player's profile or proposing a trade, you'll see their trade preferences displayed as badges. This helps you understand their trading style before reaching out.

If they're tracking daily sends, you'll also see how many sends they have left today (e.g., "📤 2/3 sends")—useful for knowing if they can send right now or if you should wait.

What is a trade agreement?

A trade agreement is a simple 1-for-1 trade proposal between you and a friend. It creates a shared page where you can both: agree on which two cards are being exchanged, mark your card as sent, and confirm receipt once it arrives.

It’s designed to reduce “who’s sending what?” confusion—especially when you’re coordinating in chat while the in-game mail is happening.

How do I propose a trade agreement?

Go to Matches, find the trading partner, and (if you’re already friends) click “Propose Trade”. You’ll pick:

  • Card I want: the card they’ll send you
  • Card I’ll give: the card you’ll send them

Trade proposals are limited to mutual matches in the active collection (so both sides are cards you can actually trade).

Do we have to be friends to propose a trade?

Yes. Trade agreements are only available with confirmed friends. If you’re not friends yet, send a friend request first, then come back to Matches and you’ll see the “Propose Trade” button once the friendship is accepted.

Can I counter-propose instead of accepting?

Yes. If you receive a proposal, you can Accept, Decline, or click “Counter-Propose” to send a new 1-for-1 proposal back (linked to the original).

Can I amend a trade agreement?

Yes. Once an agreement is accepted (and before both sides have sent), you can propose an amendment to change the cards. Amendments are a new proposal linked to the original agreement.

If the amendment is accepted, the original agreement is automatically marked as superseded so you can focus on the updated deal.

Can I cancel a trade agreement?

You can cancel an agreement as long as it’s still Proposed or Accepted and both sides haven’t sent yet. This helps avoid accidental trades if plans change.

Do we have to accept before sending cards?

Not necessarily. An agreement lets either side mark their card as sent even while the proposal is still pending (some players like to send first to show good faith).

Tip: only send early if you’re comfortable with the risk—acceptance is still the “official” acknowledgement of the deal.

How do we mark cards as sent and confirm receipt?

Open the agreement (from the Trades page, then the Agreements tab). After you send the card in Township, click “I Sent It”. When you receive a card, click “Confirm Receipt”.

Once both sides have been received and confirmed, the agreement is automatically marked Completed.

Will I get notified about trade agreements?

Yes. Proposals and responses show up in your Messages inbox. You can also enable/disable trade agreement emails from Email Preferences.

What is the Trades page?

The Trades page is your central hub for managing all your trades. It has two tabs:

  • Pending: See trades awaiting action—split into "Awaiting Your Action" (trades you need to confirm) and "Awaiting Their Confirmation" (trades you sent)
  • History: View all your confirmed trades in chronological order, showing who you traded with and when

You can access the Trades page from the navigation menu. If you have pending trades, you'll see a badge count showing how many need attention!

How do I see all my pending trades in one place?

Click "Trades" in the navigation menu and select the Pending tab. You'll see:

  • Awaiting Your Action: Trades where someone sent you a card and you need to confirm receipt. These show a pulsing indicator and a "Confirm" button.
  • Awaiting Their Confirmation: Trades where you sent a card and are waiting for the recipient to confirm. These show a "Pending" badge and a "Cancel" option.

The Trades page shows trades from all your trading partners in one convenient list, rather than having to check each partner individually on the Matches page.

What's the difference between Matches and Trades?

Think of them as two stages of the trading process:

  • Matches: "Who can I trade with?" — Discovery and initiating trades with potential partners
  • Trades: "What trades am I doing?" — Managing active trades and viewing your trading history

Use Matches to find new trading partners and start trades. Use Trades to track what's in progress and see your history.

How do I track trades?

When you're ready to mark a trade as complete, simply click on the card you're giving in the "You can give them" section. You'll see a confirmation dialog where you can add optional notes (like "traded via Reddit"). Once confirmed, the trade is marked as complete and the card will show a "Pending" status until your trading partner confirms they received it.

For cards you receive: When someone marks a trade complete with you, you'll see a "Pending" indicator on that card. Click it to confirm you received the card, which completes the trade for both parties. After confirming, you'll be asked if you want to add the card to your inventory—choose "Yes" to update automatically or "No" to update manually later.

You can view all your trades (both given and received) in the "Trades You Gave" and "Trades You Received" sections on each partner's match card. Pending trades can be undone if needed, but once confirmed by the recipient, they're permanent.

How do I log a trade that happened outside matches?

Use the "Log Trade" button on the Trades page or on a friend's profile (only visible when you are friends). You'll choose whether I sent or I received, select the card, and optionally add notes.

Manual trades are recorded as confirmed immediately and appear in your History. No match is required.

What happens after I confirm a received card?

After confirming (or logging) a received card, you'll be asked if you want to update your inventory right away:

  • Yes, add to inventory: We increment the card count and recalculate matches.
  • No, I'll update later: No inventory changes are made.

Do manual trades send notification emails?

No. Manual trade entries do not send trade emails. This prevents accidental spam to your trading partner (or yourself) when you're just logging history.

What does "Pending" mean on a trade?

A trade shows "Pending" status when one person has marked it complete, but the other person hasn't confirmed yet. This gives both parties a chance to verify the trade happened before it's marked as fully confirmed.

  • If you gave a card: It shows "Pending" until the recipient clicks to confirm they received it. You'll see an "Undo" button if you need to cancel before they confirm.
  • If you received a card: You'll receive an email notification with a "Confirm Receipt" button. You can also confirm directly from the matches page by clicking the "Pending" indicator.

Once both parties have confirmed, the trade shows as "Confirmed" and cannot be undone. This helps prevent accidental cancellations and keeps your trading history accurate.

Can I undo a trade?

Yes, but only if the other person hasn't confirmed yet. If you marked a trade complete but need to undo it (maybe you made a mistake or the trade fell through), you can click the "Undo" button next to pending trades in the "Trades You Gave" section.

Important: Once the recipient confirms they received the card, the trade cannot be undone. This protects both parties and keeps trading history accurate.

📧 Notifications & Emails

Will I get notified about new matches?

Yes! We send a daily email digest whenever you have new matches. Important: You must verify your email address to receive match notifications. If you haven't verified your email yet, you'll receive a reminder email instead of the full match details (to protect privacy).

Once verified, the email organizes matches into three categories:

  • ✨ Mutual Trades: Partners you can trade with in both directions
  • 📥 Cards You Can Receive: Partners who have cards you need
  • 📤 Cards You Can Give: Partners who need cards you have

Each section shows the partner's game name, friend code, and specific cards involved. Emails are sent once daily at 10 AM PST. You'll only receive an email if you have new matches!

Why do I need to verify my email?

Email verification protects your privacy and the privacy of other players. Until you verify your email, we won't show you detailed match information (like partner names and friend codes) in emails. Instead, you'll receive a reminder to verify your email so you can see your matches.

After verifying, clicking the verification link will automatically take you to your matches page if you have any waiting matches. If you don't have matches yet, you'll be taken to your profile page.

Will I get notified when someone marks a trade complete with me?

Yes! When someone marks a trade complete and gives you a card, you'll receive an email notification immediately. The email includes:

  • The card name, star rating, and set name
  • The giver's game name and friend code
  • A "Confirm Receipt" button that takes you directly to the confirmation page
  • A link to view all your matches

Click the "Confirm Receipt" button in the email to confirm you received the card. This helps track successful trades and builds trust in the community. You can also confirm trades directly from the matches page if you prefer.

Note: You must have a verified email address to receive trade notifications. If your email isn't verified, you'll need to check the matches page manually to see pending trades.

Can I turn off email notifications?

Yes! You can control which emails you receive from the Email Preferences page. You can toggle:

  • Daily Match Digest: The daily email summarizing new trading opportunities
  • New Message Notifications: Emails when friends send you messages (coming soon)

To access your email preferences, go to your Profile and click "Email Preferences". Changes take effect immediately.

Note: Even if you turn off the Daily Match Digest, you'll still receive verification reminder emails if your email isn't verified yet. This ensures you can complete verification to access full features.

How do I access my email preferences?

There are two ways to access your email preferences:

  • From your Profile page, click the "Email Preferences" link
  • Click "Manage email preferences" at the bottom of any daily match digest email

Your preferences are saved automatically when you toggle them—no need to click a save button!

👥 Friends & Profiles

What is the Friends Hub?

The Friends Hub is your central location for managing friendships. It has three tabs:

  • Pending: See incoming friend requests you can accept or decline, and outgoing requests you're waiting on
  • Friends: View all your confirmed friends with their friend codes and when you became friends
  • Find Friends: Discover new players to trade with, search by game name, and see match potential before connecting

You can access the Friends Hub from the navigation menu. It shows badge counts for pending requests so you never miss a new connection!

How do I find new trading partners?

Use the Find Friends tab in the Friends Hub to discover other players. You can:

  • Browse all players who have set up their profiles
  • Search by game name to find specific players
  • See match potential badges showing how many cards you could trade
  • Send friend requests directly from the discovery list
  • Click on any player to view their full profile

Players you're already friends with, or have pending requests with, won't appear in the discovery list—so you'll only see new potential connections!

How do Friends filters and sorting work?

Both Friends and Find Friends use match-style filters to help you focus on the best trading partners:

  • All / Mutual / I Need / They Need: Quickly narrow by trade direction
  • Trusted Trader (Find Friends): Show verified, high-trust partners
  • Never Traded (Friends): Find connections you have not traded with yet
  • Any TZ / Same TZ / Within 2h / Within 4h: Filter by timezone proximity (requires a saved timezone)

Use the search box to filter by game name. The default sort highlights the best trade matches first, and you can switch to A-Z, Most Trades, Cards for Me, or Cards for Them from the dropdown.

What can I see on player profiles?

Click on any player's name to view their public profile. You'll see:

  • Player info: Game name, friend code, and when they joined
  • Match Potential: How many cards they have that you need, and how many you have that they need
  • Active Collection Progress: Their inventory for the current collection, organized by set
  • Card Details: Expand any set to see exactly which cards they need, have, or have extras of
  • Past Collections: Summary of their completion rates on previous collections

You can send friend requests or manage your friendship status directly from their profile page!

How does the friend request system work?

The friend request system helps you track which trading partners you've added as friends in Township. On each match card or profile, you'll see friend request buttons:

  • "Send Request" - Click this after you send a friend request in Township
  • "Already friends in game?" - Use this if you're already friends in the game

After you mark a request as sent, the other player will see it on their end and can confirm by clicking "I Accepted" once they accept your request in Township. Once confirmed, you'll both see a green "Friends ✓" badge.

Why track friendships? Knowing who you're already friends with helps you prioritize trades and builds trust in the community. Future features will let you filter matches by friend status!

Will I get notified about friend requests?

Yes! You'll receive email notifications for friend request activity:

  • When someone sends you a request: You'll get an email with their game name and friend code so you can add them in Township
  • When your request is accepted: You'll get a confirmation email when someone confirms your friendship
  • When someone connects you as friends: If someone marks you as "already friends," you'll get notified

Each email includes a direct link to your matches page where you can respond or start trading. Notifications are sent immediately—no waiting for a daily digest!

Privacy note: Emails only show game names and friend codes—never email addresses.

Can I re-send a friend request after being declined?

Yes! If someone declines your friend request (or if you decline theirs), they'll reappear in your Find Friends list. This allows you to re-request if circumstances change—maybe they were busy or it was accidental.

Similarly, if you remove a friend, they'll appear in Find Friends again if you want to reconnect later.

💬 Messaging

How do I send a message to another player?

You can send messages to your friends from two places:

  • From their profile: Visit a friend's profile page and click the blue "Message" button next to their "Friends ✓" badge
  • From match cards: On the matches page, click the "Message" button that appears next to the "Friends ✓" badge on any friend's match card

You'll be taken to a message compose form where you can type your message (up to 2,000 characters) and send it.

Who can I message?

You can only send messages to confirmed friends. This means:

  • You need to have an accepted friendship with the player
  • Players with pending friend requests cannot be messaged yet
  • Players you're not connected with won't show a Message button

This helps protect everyone's privacy and ensures you're only communicating with people you've connected with.

Is my email address shared when I message someone?

No, never! Your email address is never exposed to other players. Messages are sent through our platform only. Recipients see your game name and friend code, but never your email address.

This privacy-first approach lets you coordinate trades safely without revealing personal contact information.

What is the message character limit?

Messages can be up to 2,000 characters long. The compose form shows a character counter so you can see how much space you have left as you type.

Messages are plain text only—no HTML or special formatting.

Where can I see messages I've received?

Click "Messages" in the navigation menu to open your inbox! You'll see:

  • All your conversations grouped by trading partner
  • Unread message count badges for each conversation
  • Preview of the last message in each conversation
  • Conversations sorted by most recent message first

Click any conversation to see the full message thread and reply directly!

How do I reply to a message?

Open a conversation from your inbox and you'll see the full message thread with a reply form at the bottom. Just type your message and click "Send"!

Messages appear in chronological order—your sent messages appear on the right in blue, and received messages appear on the left. Each message shows the timestamp so you can follow the conversation flow.

What does the unread badge in the navigation mean?

The number next to "Messages" in the navigation shows how many unread messages you have across all conversations. When you view a conversation, those messages are automatically marked as read.

Note: The badge updates when you refresh the page. Real-time updates are planned for a future release!

🏆 Leaderboards

What are the leaderboards?

The Leaderboards show the top traders and most connected players in our community! There are four leaderboards:

  • Most Cards Traded: Total trading activity (cards given + cards received)
  • Most Cards Received: Cards you've received from other players
  • Most Cards Given: Cards you've generously given to others
  • Most Friends: Players with the most accepted friendships in our community

Each leaderboard shows the top 10 traders with gold, silver, and bronze medals for the top 3 positions.

How do I get on the leaderboard?

Simply trade cards! Every confirmed trade counts toward your leaderboard ranking. When you give a card to someone and they confirm receipt, it counts toward your "Cards Given" total. When you receive a card and confirm it, it counts toward your "Cards Received" total. Both count toward your "Cards Traded" total.

What if I'm not in the top 10?

If you're logged in but not in the top 10, you'll see a "Your Position" section below the leaderboard. This shows your current rank along with the players just above and below you, so you can see how close you are to climbing the ranks!

How are ties handled?

We use standard ranking for ties. If two players have the same number of trades, they share the same rank, and the next rank skips. For example, if two players are tied for 2nd place, the next player would be ranked 4th (not 3rd).

Do I need to be logged in to see the leaderboards?

No! Leaderboards are public and anyone can view them. However, if you're logged in, your row will be highlighted so you can easily spot your position, and you'll see the "Your Position" section if you're outside the top 10.

How does the Friends leaderboard work?

The Friends leaderboard shows the most connected players in our community, ranked by accepted friend count. Each accepted friendship counts for both users involved—so if you and another player are friends, you both get +1 to your friend count.

Only accepted friendships count. Pending friend requests don't appear on the leaderboard. This encourages community building and helps you find active, engaged trading partners!

🛡️ Trust & Safety

How do I report a user?

If you experience harassment, abuse, or trade fraud from another user, you can report them directly from their profile page. Look for the "Report User" link in the profile header (below the friend code).

When you click "Report User", a modal will appear where you can:

  • Select a category: Harassment, Abuse, or Trade Fraud
  • Optionally link evidence (a recent trade or message with that user)
  • Add additional details describing what happened

After submitting, you'll see "Already reported" on their profile, and our team will review the report.

What happens after I report someone?

Your report is added to our admin review queue. Our team reviews each report and may take action including warnings or account restrictions. We take all reports seriously and work to keep the community safe for everyone.

Note: You can only have one pending report per user. Once your report is reviewed and resolved, you can submit a new report if needed.

What counts as trade fraud?

Trade fraud includes situations where a user agrees to trade but doesn't follow through—for example, receiving your card but never sending theirs in return. If you experience this, report the user with the "Trade Fraud" category and link the relevant trade as evidence.

Tip: Trading with friends you've built a relationship with reduces the risk of trade fraud. Use the messaging system to coordinate trades before sending cards in-game!

What does "Trade Restricted" mean?

If you see a "Trade Restricted" badge on a user's profile or next to their name on the matches page, it means that user has been temporarily restricted from receiving trades due to community guideline violations.

Trade-restricted users can still log in, view matches, and message friends—but other users cannot send trades to them until the restriction expires. The badge shows the expiry date so you know when they'll be able to trade again.

Why can't I send a trade to this user?

If you see "Blocked" on a Give card or receive the message "This user is currently restricted from receiving trades", the user has been temporarily trade-restricted by our moderation team.

This protection exists to prevent bad actors from continuing to receive cards from the community while their behavior is being addressed. You can still message them and be friends—trading will resume when their restriction expires.

I was trade-restricted. What happened?

If you received an email about a trade restriction, it means our moderation team reviewed reports about your account and determined that a temporary restriction was warranted. The email explains the reason and duration of the restriction.

During a trade restriction, you can still:

  • Log in and use the site
  • View your matches and inventory
  • Message friends and send friend requests
  • Give cards to other users

However, other users cannot send trades to you until the restriction expires. Repeated violations may result in longer restrictions or permanent account suspension.

My account was suspended. What can I do?

Account suspensions are reserved for serious or repeated violations of our community guidelines. If your account has been permanently suspended, you will not be able to log in.

If you believe this was a mistake, an appeal system is coming soon. Until then, please be patient as we build out that feature.

What are the badges I see next to usernames?

We've introduced trust badges to help you make informed decisions about who to trade with. Badges appear next to usernames throughout the site—on profiles, matches, friends lists, messages, and leaderboards.

There are two types:

  • 🛡️ Trusted Trader (green shield) — This trader has a proven track record of successful trades and is generally safe to trade with.
  • ⚠️ Warning badges (colored pills) — These indicate something to be aware of before trading with this user.

What does the green shield icon mean?

The 🛡️ green shield next to a username indicates a Trusted Trader. These users have completed multiple successful trades with good confirmation rates and participate actively in both giving and receiving cards.

Tip: Trading with Trusted Traders is generally safer, but always use good judgment and communicate before sending valuable cards!

How do I become a Trusted Trader?

The Trusted Trader badge is earned automatically based on your trading activity. To qualify, you need to:

  • Complete several successful trades
  • Maintain a good confirmation rate (confirm when you receive cards!)
  • Participate in both giving and receiving trades
  • Have no outstanding issues with your account

Just keep trading fairly, confirm your receipts, and the badge will appear automatically once you qualify!

What does "Under Review" mean?

The ⚠️ Under Review badge means this user's account is currently being reviewed by our moderation team due to reports from multiple community members.

You can still trade with them, but you may want to exercise extra caution—perhaps trade lower-value cards first or wait until the review is complete.

What does "Trade Caution" mean?

The ⚡ Trade Caution badge indicates this user has a lower-than-average trade confirmation rate. This could mean they're slow to confirm trades, inactive, or have had issues completing trades in the past.

Tip: Consider messaging them first to confirm they're active before sending cards. Start with lower-value trades to build trust.

What does "New Account" mean?

The 🆕 New Account badge simply means this user joined recently. It's not a warning—everyone starts somewhere! It just lets you know they don't have an established track record yet.

New users can still be great trading partners. Consider starting with smaller trades to help them build their reputation.

Why don't I see any badge on a user?

Not everyone has a badge! If a user doesn't show any badge, it means:

  • They haven't completed enough trades yet to qualify for Trusted Trader
  • Their account is older than 7 days (so no "New Account" badge)
  • They don't have any warning conditions

No badge is neutral—it's neither good nor bad. Use your judgment and communicate with potential trading partners!

❓ General Questions

Is this tool free?

Yes! Township Cards is 100% free with no ads and no paywall. It's a fan-made community tool to help Township players find trading partners more easily.

Is this affiliated with Playrix?

No, this is a fan-made tool and is not affiliated with or endorsed by Playrix. Township is a trademark of Playrix.

Roadmap

✅ Recently Completed

  • ✓ Trade Preferences: Set your trading style (Mutual Only, Equal Value, Generous Trader, Star Range) so others know how you like to trade
  • ✓ Daily Send Tracking: Track your 3 daily sends with quick controls on the Matches page—log sends, reset daily, and see status everywhere
  • ✓ Agreement Amendments & Cancellations: Update accepted agreements or cancel before both sides send
  • ✓ Timezone Proximity Filters: Filter Matches, Friends, and Find Friends by Same TZ or within 2–4 hours
  • ✓ Match Card Indicator Legend: Always-on legend plus Pending agreement indicators to prevent duplicate trades
  • ✓ Agreement Availability Warnings: If you no longer have a required card, you'll see a warning before marking sent
  • ✓ Mutual Trade Agreements: Propose a 1-for-1 trade to friends, accept/decline/counter, and track sent + receipt confirmations in one shared view
  • ✓ Friends Filters & Sorting: Match-style filters, default relevance sorting, and search on Friends and Find Friends
  • ✓ Friend Match Potential Counts: See how many cards you can give/receive directly on friend cards
  • ✓ Smarter Daily Match Emails: Digest now shows accurate totals but only previews up to 3 traders per section
  • ✓ Manual Trade Entry: Log sent/received trades from the Trades page or a friend's profile, with instant history updates
  • ✓ Searchable Trade Forms: Type-to-search partner and card selection when logging manual trades
  • ✓ Timezone Settings: Set your timezone in your profile to see all dates and times in your local time—we'll even detect your browser timezone automatically!
  • ✓ Timezone Offset Indicators: See how many hours ahead or behind other players are (e.g., "+3h" or "-5h") to help coordinate trades across time zones
  • ✓ Profile Completion Gate: Users must set game_name and friend_code before accessing matches, inventory, friends, trades, and messages—leaderboards and public profiles remain accessible
  • ✓ Email Verification Gate: Verified email required for outbound actions (sending friend requests, creating trades, sending messages)—inbound actions work without verification
  • ✓ Clickable Leaderboard Names: Player names on leaderboards now link to their profiles for easy discovery
  • ✓ Trust Badges: See at a glance who's a Trusted Trader (green shield), Under Review, Trade Caution, or New Account—badges appear everywhere usernames are shown
  • ✓ Trusted Trader Status: Earn a green shield badge by maintaining good trading habits—active traders with solid confirmation rates qualify automatically
  • ✓ Ban System: Admins can soft-ban (temporary trade restriction) or hard-ban (permanent suspension) users who violate community guidelines
  • ✓ Trade Restricted Badges: Visual indicators on profiles and match cards showing when users are trade-restricted
  • ✓ Three Strikes Rule: Third soft ban automatically escalates to permanent account suspension
  • ✓ Admin Review Queue: Moderation queue with user details, trade stats, and audit logging for all admin actions
  • ✓ Report User: Flag users for harassment, abuse, or trade fraud directly from their profile with evidence linking and notes
  • ✓ Email Preferences: Control which emails you receive—toggle Daily Match Digest and Message Notifications on/off from your profile
  • ✓ Trades Page: Central hub for managing all trades with Pending and History tabs
  • ✓ Friend Trade History: See trade summary on friend cards with expandable details
  • ✓ Filter Matches by Friend: Click "Find trading opportunities" on a friend to see only matches with them
  • ✓ Match Filters: Filter matches by type (All, Mutual, I Give, I Receive) and star rating (All Stars, 3+ Stars)
  • ✓ Friends Leaderboard: See the most connected players ranked by accepted friend count
  • ✓ Leaderboards: See top traders with Most Cards Traded, Most Cards Received, and Most Cards Given rankings
  • ✓ Message Inbox: View all your conversations, see unread counts, and reply to messages directly
  • ✓ Messaging: Send messages to friends to coordinate trades (no email exposure)
  • ✓ Friends Hub: Central location for managing friendships with Pending, Friends, and Find Friends tabs
  • ✓ Public User Profiles: View any player's inventory, match potential, and collection progress
  • ✓ Find Friends Discovery: Browse and search for new trading partners with match potential badges
  • ✓ New Journey Collection: The new Journey collection with 15 sets and 150 cards is now live!
  • ✓ Collection Transition System: Seamless handling when new collections are released—your old data is preserved and the new collection activates automatically
  • ✓ Inventory Update Prompt: After marking a trade complete, prompted to confirm if you still have extras—inventory updates automatically based on your answer
  • ✓ Smart Empty States: Context-aware messaging on matches page based on your inventory status
  • ✓ Email Verification Guard: Privacy protection - unverified users receive reminders instead of match details
  • ✓ Smart Redirects: After email verification, automatically taken to matches page if you have matches
  • ✓ Enhanced Email Digest: See cards you can receive AND cards you can give in organized sections
  • ✓ Daily Email Digest: Get notified when new matches appear (daily at 10 AM PST)
  • ✓ Match Type Badges: See ✨ Mutual Trade and 🎁 One-Way indicators
  • ✓ Friend Request System: Send friend requests, confirm friendships, and see friend status badges on match cards
  • ✓ Friend Request Notifications: Get email notifications when you receive friend requests, when requests are accepted, or when someone connects you as friends
  • ✓ Trade Tracking: Mark trades complete, confirm receipt, track trading history, and undo pending trades
  • ✓ Trade Notifications: Get email notifications when someone marks a trade complete with you, including card details and one-click confirmation
  • ✓ Receiver Inventory Prompt: After confirming a received trade, choose to add the card to your inventory automatically or update manually later
  • ✓ Collection Completion Detection: Automatic detection and celebration when you complete a collection with confetti animation and email notification
  • ✓ Collection Reset: Reset your collection after completion and start a new round—reset all cards to 0 and begin collecting again

🚧 Coming Next

  • ○ Best Match Score: See a "match score" showing how compatible each partner is for trading
  • ○ Sort by Best Match: Sort partners by match score to find your best trading opportunities first
  • ○ Filter by Friend Status: Filter matches to show only friends or non-friends
  • ○ Collection History View: Browse your past collections and see your historical card data

🎮 Gamification (Coming Later)

  • ○ Completion Badges: Display completion badges on your profile for others to see
  • ○ XP System: Earn XP for trades, completions, and community participation
  • ○ Achievements: Earn badges and trophies for milestones (trades, friends, completions)
  • ○ Activity Timeline: See what's happening with your friends and the community

🔮 Future Ideas

  • ○ Co-Op Support: Join your co-op, see co-op leaderboards
  • ○ Screenshot OCR: Upload screenshots to auto-detect your cards
  • ○ Mobile App: Native app with push notifications

Changelog

Version 1.22.0

February 1, 2026
  • Trade Preferences: Set your trading style in Profile Settings—Mutual Only, Equal Value, Generous Trader, or Star Range
  • Preference Badges: Your trade preferences display as badges on profiles, match cards, and trade proposals
  • Daily Send Tracking: Track your 3 daily sends with controls right on the Matches page
  • Quick Send Controls: Log sends with one click, reset at the start of each day, see remaining sends everywhere
  • Partner Send Status: See how many sends trading partners have left (e.g., "2/3 sends") on their profiles

Version 1.21.0

January 31, 2026
  • Agreement Amendments: Propose updated cards after acceptance, with clear linkage to the original
  • Agreement Cancellations: Cancel proposed or accepted agreements before both sides send
  • Cancellation Messaging: In-app and email notifications keep both parties in sync

Version 1.20.0

January 31, 2026
  • Timezone Proximity Filters: New Same TZ / 2h / 4h filters on Matches, Friends, and Find Friends
  • Match Card Indicator Legend: Always-visible legend with clearer Pending state on match tiles
  • Agreement Availability Checks: Warnings now detect unavailable cards across all agreement items
  • Reliability & Security: Fixed timezone offset edge cases, preserved filters in redirects, and hardened return URLs

Version 1.19.0

January 26, 2026
  • Mutual Trade Agreements: Propose a 1-for-1 trade to friends directly from Matches
  • Counter-Proposals: Recipients can counter instead of accepting/declining
  • Agreement Progress Tracking: Mark your card as sent, confirm receipt, and auto-complete when both sides are confirmed
  • Agreements Inbox: View all received and sent agreements from the Trades → Agreements tab
  • Notifications: In-app messages for proposals and responses, plus optional email notifications

Version 1.18.0

January 24, 2026
  • Friends Filters: All/Mutual/I Need/They Need plus Trusted Trader and Never Traded filters
  • Friends Search: Search by game name on the Friends list
  • Smarter Sorting: Default relevance sort and expanded sort options across Friends and Find Friends
  • Match Potential Counts: Friend cards now show cards they need and cards you need

Version 1.17.1

January 18, 2026
  • Daily Match Digest Preview: Email now caps each section to 3 traders while keeping accurate totals
  • Cleaner Teasers: Added “and X more traders” to avoid long walls of matches

Version 1.17.0

January 18, 2026
  • Manual Trade Entry: Log sent or received trades outside matches from the Trades page or friend profiles
  • Instant History: Manual entries are confirmed immediately and show up in History
  • Inventory Prompt: When you log a received card, choose whether to add it to inventory right away
  • Searchable Selects: Type-to-search partner and card fields on the manual trade form
  • Manual Trade Label: Manual entries are labeled in trade history

Version 1.16.0

January 17, 2026
  • Timezone Settings: Set your timezone in Profile Settings to see all times in your local time
  • Browser Auto-Detection: Your timezone is automatically detected from your browser and pre-filled
  • Timezone Offset Indicators: See "+3h" or "-5h" next to usernames showing the time difference from you
  • Global Time Display: All timestamps across the site (messages, trades, profiles) now show in your timezone
  • Email Times: Email notifications now show times in your timezone too
  • Timezone Reminder: Friendly banner prompts you to set your timezone if you haven't yet
  • Offset only shown when both you and the other user have timezones set
  • DST-aware calculations ensure accuracy year-round

Version 1.15.0

January 16, 2026
  • Profile Completion Gate: New users must set game_name and friend_code before accessing core features
  • Gated features: Matches, My Collection, Friends Hub, Trades, and Messages require profile completion
  • Always accessible: Public profiles and leaderboards remain viewable without completing your profile
  • Email Verification Gate: Verified email required for outbound social actions
  • Outbound-only gating: Sending friend requests, creating trades, and sending messages require verification
  • Inbound always works: Accept friend requests, confirm trades, and read messages without verification
  • Simplified navigation: Incomplete profiles see only "Profile Setup" and "Log Out" until profile is complete
  • Clickable leaderboards: Player names on leaderboards now link directly to their profiles
  • Friendly flash messages guide users to complete profile or verify email when needed

Version 1.14.0

January 16, 2026
  • Trust Badges: Visual indicators to help you make informed trading decisions
  • Trusted Trader: Green shield icon next to usernames for traders with proven track records
  • Under Review Badge: Orange badge when multiple users have reported an account
  • Trade Caution Badge: Yellow badge for users with lower confirmation rates
  • New Account Badge: Gray badge for accounts less than 7 days old
  • Badge Hierarchy: Only the most relevant badge shows (warnings take priority)
  • Badges visible everywhere: profiles, matches, friends, messages, trades, leaderboards
  • Hover tooltips explain what each badge means
  • Admin kill switch to globally enable/disable badges if needed

Version 1.13.0

January 15, 2026
  • Ban System: Admins can now soft-ban (7/14/30 days) or hard-ban users who violate community guidelines
  • Three Strikes Rule: Third soft-ban automatically escalates to permanent ban
  • Trade Restricted Badges: Visual indicators on profiles and match cards for trade-restricted users
  • Automatic Expiry: Soft-bans automatically lift when duration expires via background job
  • Hard Ban Protection: Blocks friend code reuse to prevent ban evasion
  • Email notifications sent when users are banned or unbanned
  • Full audit trail for all ban/unban actions

Version 1.12.0

January 14, 2026
  • Admin Review Queue: Prioritized moderation queue sorted by reporter count and recency
  • User Detail View: Comprehensive view showing flags, trade stats, recent trades, and messages
  • Flag Resolution: Admins can dismiss flags with full audit trail logging
  • Trade Statistics: See user's trades given, trades received, and confirmation rate
  • All admin actions logged for accountability and transparency

Version 1.11.0

January 13, 2026
  • Report User: Flag users for harassment, abuse, or trade fraud directly from their profile
  • Category Selection: Choose from Harassment, Abuse, or Trade Fraud with helpful descriptions
  • Evidence Linking: Optionally attach a recent trade or message as evidence
  • Notes Field: Add additional context describing what happened (up to 500 characters)
  • Duplicate Prevention: One pending report per user—"Already reported" shown if you've flagged them
  • Admin dashboard now shows real-time count of flagged users pending review
  • Reports preserved even if linked trade/message is later deleted

Version 1.10.0

January 11, 2026
  • Email Preferences: New settings page to control which emails you receive
  • Daily Digest Toggle: Turn off daily match notification emails if you prefer to check manually
  • Message Notifications Toggle: Control whether you get emails when friends message you (coming soon)
  • Access preferences from your Profile page or via link in digest emails
  • Instant save—toggle changes apply immediately with visual feedback
  • Verification reminders still sent regardless of preferences (until you verify)

Version 1.9.0

January 11, 2026
  • Trades Page: New central hub for managing all your trades in one place
  • Pending Tab: See trades split into "Awaiting Your Action" (incoming) and "Awaiting Their Confirmation" (outgoing)
  • History Tab: View all confirmed trades chronologically with direction indicators and pagination
  • Trades navigation item with pending count badge shows how many trades need attention
  • Confirm incoming trades or cancel outgoing trades directly from the Pending tab
  • Empty states with "Find Matches" CTA when no pending or confirmed trades exist
  • Friend Trade History: See trade summary on friend cards in the Friends Hub
  • Trade summary shows cards given, cards received, and total trade count with each friend
  • Expandable trade history details load on-demand for performance
  • "View Trade History" link on friends with previous trades
  • "Find trading opportunities" link on friends with no trades—now goes to filtered matches!
  • Filter Matches by Friend: Narrow the Matches page to a specific friend
  • Green filter banner shows "Showing matches with @FriendName" with "Show All" link
  • Friend filter combines with existing type and star filters
  • All filter links and pagination preserve the friend_id parameter

Version 1.8.0

January 9, 2026
  • Match Filters: Filter your trading partners by match type and card star rating
  • Type filters: All (default), Mutual (two-way trades), I Give (one-way where you give), I Receive (one-way where you receive)
  • Star filter: All Stars (default) or 3+ Stars to focus on high-value cards
  • Combine filters with AND logic — e.g., "Mutual" + "3+ Stars" shows only mutual partners for 3+ star cards
  • Filters preserved in URL params — bookmark filtered views or share specific filter links
  • Filter buttons styled as pills with active state highlighting
  • Filtered empty state shows "No matches for current filters" with "Clear Filters" button
  • Pagination preserves filter params when navigating between pages
  • Accessible filter UI with aria-labels for screen readers

Version 1.7.1

January 9, 2026
  • Friends Leaderboard: New "Friends" tab showing players ranked by accepted friend count
  • Bidirectional counting: each friendship counts for both users (+1 for requester and +1 for addressee)
  • Only accepted friendships count—pending requests don't appear on the leaderboard
  • Type-aware UI: empty states, subtitles, and champion titles adapt to the leaderboard type
  • Same ranking system as other leaderboards: top 3 get medals, ties share ranks
  • "Your Position" section works for friends leaderboard when you're outside the top 10
  • Public access: view friends rankings without logging in

Version 1.7.0

January 9, 2026
  • Leaderboards: See top traders in our community with three leaderboard types
  • Most Cards Traded: Total trading activity (cards given + received)
  • Most Cards Received: Cards received from other players
  • Most Cards Given: Cards generously given to others (generosity metric!)
  • Top 3 positions get gold, silver, and bronze medals with champion spotlight for #1
  • Standard ranking system: ties share ranks, next rank skips
  • "Your Position" section shows your rank if you're outside the top 10
  • Public access: anyone can view leaderboards without logging in
  • Your row is highlighted when logged in so you can easily spot your position
  • Leaderboards link added to main navigation

Version 1.6.1

January 8, 2026
  • Security Update: Updated action_text-trix to fix XSS vulnerability
  • Pagination Fix: Fixed missing ellipsis in pagination (e.g., "1 ... 4 5 6 ... 10" now shows both gaps)
  • Dependency Upgrade: Upgraded pagy to v43 with new simplified API

Version 1.6.0

January 4, 2026
  • Message Inbox: View all your conversations in one place
  • Conversations grouped by trading partner with last message preview
  • Unread message count badges on each conversation and in navigation
  • Conversations sorted by most recent message first
  • Click into any conversation to see full message thread in chronological order
  • Sent messages appear on the right (blue), received on the left (gray)
  • Messages automatically marked as read when you view a conversation
  • Inline reply form at bottom of conversation—no need to navigate away
  • Empty states for inbox with no messages and conversations with no history
  • "Messages" link added to navigation with unread badge (updates on page refresh)

Version 1.5.0

January 4, 2026
  • Messaging: Send messages to friends to coordinate trades privately
  • Message button appears next to "Friends ✓" badge on profiles and match cards
  • Compose form with character counter (max 2,000 characters)
  • Messages are plain text only for email forwarding compatibility
  • Privacy-first: email addresses are never exposed to other users
  • Only confirmed friends can message each other (pending requests cannot message)
  • Cancel button preserves your navigation context (returns you to where you came from)
  • XSS protection on all message inputs

Version 1.4.0

January 3, 2026
  • Friends Hub: New central location for managing all your friendships
  • Three tabs: Pending (incoming/outgoing requests), Friends (confirmed friends), Find Friends (discover new players)
  • Search for players by game name in Find Friends tab
  • Match potential badges show how many cards you could trade with each player
  • Pagination for browsing large player lists
  • Public User Profiles: Click any player's name to view their profile
  • See player info: game name, friend code, join date
  • View their complete inventory for the active collection, organized by set
  • Expandable accordion shows card details: what they need, have, or have extras of
  • Match potential section shows exactly what you could trade
  • Past collection summaries show completion rates
  • Send friend requests or manage friendship status directly from profiles
  • Re-request friendships after rejection—declined users reappear in Find Friends
  • Turbo Stream updates for instant UI feedback on all friendship actions

Version 1.3.0

January 2, 2026
  • New Journey Collection: The Journey collection is now live with 15 sets featuring destinations around the world
  • 15 themed sets: Greece, Tropics, Mexico, Mysterious East, Japan, Egypt, France, Brazil, China, Germany, Italy, Great Britain, USA, Vikings, and Africa
  • 150 total cards ranging from 1-5 stars with gold (non-shareable) cards in later sets
  • Collection runs until March 6, 2026
  • Collection Transition System: Seamless transition when new collections are released
  • Previous collection (Winter) is preserved but deactivated
  • All your Winter collection cards, trades, and completion records remain in the database
  • Matches automatically recalculate for the new Journey collection
  • Activation/deactivation timestamps added for audit trail
  • System logs collection transitions for debugging and monitoring

Version 1.2.0

January 2, 2026
  • Collection Reset: Reset your collection after completion and start a new round
  • After completing a collection, see a "🔄 Start New Round" button in the completion badge
  • Confirmation modal shows next round number and warns that all cards will be reset to 0
  • Previous completion records are preserved—only card quantities reset to 0
  • Round number indicator updates automatically (e.g., "Round 2") based on completion history
  • Receive an email notification when you reset, encouraging you to start collecting again
  • Matches automatically recalculate after reset based on your new (empty) inventory
  • Reset button only appears when you've completed the collection and currently own all cards
  • Cannot reset ended collections—they become read-only
  • Modal can be dismissed with Cancel button or ESC key
  • Reset is transactional—either succeeds completely or nothing changes

Version 1.1.0

January 2, 2026
  • Collection Completion Detection & Celebration: Automatic detection and celebration when you complete a collection
  • See a beautiful celebration modal with confetti animation when you own all cards in a collection
  • Collection completion badge shows on your inventory page with round number (1st, 2nd, 3rd, etc.)
  • Progress bar turns amber/gold when collection is complete
  • Receive a congratulatory email when you complete a collection (includes completion round number)
  • Completion tracking records each completion round for future features
  • Automatic detection happens when you view your inventory page—no manual action needed
  • Completion detection works in real-time and handles edge cases (gold cards, multiple sets, etc.)
  • Celebration modal can be dismissed with "Awesome!" button or ESC key
  • Backfill rake task available for users who completed collections before this feature launched

Version 1.0.9

January 1, 2026
  • Receiver Inventory Prompt: After confirming you received a card, choose to add it to your inventory automatically
  • When you confirm receipt of a trade, you'll see a prompt asking "Add this card to your inventory?"
  • Choose "Yes, add to inventory" to automatically increment your card quantity by 1
  • Choose "No, I'll update later" if you prefer to update manually from the Inventory page
  • The prompt shows your current quantity of the card so you know what you're adding to
  • Inventory updates trigger automatic match recalculation to keep your matches accurate
  • Idempotency protection prevents duplicate inventory updates if you accidentally click multiple times
  • Works seamlessly with the trade confirmation flow—confirm receipt, then update inventory in one smooth process

Version 1.0.8

December 31, 2025
  • Friend Request Notifications: Stay informed about friendship activity via email
  • Receive an email when someone sends you a friend request with their game name and friend code
  • Get notified when your friend request is accepted so you know you can start trading
  • Receive notification when someone connects you as "already friends"
  • Each email includes a direct link to your matches page
  • Privacy-first: emails show game names and friend codes only—never email addresses
  • Notifications sent immediately (no waiting for daily digest)
  • Both HTML and plain text email versions for better compatibility

Version 1.0.7

December 31, 2025
  • Trade Notifications: Receive email notifications when someone marks a trade complete with you
  • Email includes card name, star rating, set name, and giver's information
  • One-click "Confirm Receipt" button in email takes you directly to confirmation page
  • Email notifications sent immediately when trades are marked complete (no daily digest delay)
  • Trade-centric confirmation URLs work even if the original match is deleted
  • Both HTML and plain text email versions for better compatibility
  • Email notifications help you stay on top of incoming trades without checking the site constantly

Version 1.0.6

December 30, 2025
  • Inventory Update Prompt: After marking a trade complete, you'll see a "Still have more?" prompt
  • Choose "Yes, I have more" or "No, that was my last" to update your inventory automatically
  • Smart defaults: if you had 3+ copies, "Yes" is pre-selected; if you had 1 copy, "No" is pre-selected
  • Your matches automatically recalculate when your inventory changes
  • Cancel a trade and your inventory is restored (if it was decremented)
  • Inventory changes are tracked per-trade to ensure accurate restoration on cancel
  • New TradeInventoryService handles all inventory operations with proper error handling
  • Idempotency protection prevents accidental double-decrements from rapid clicks
  • Race condition protection with pessimistic locking on inventory updates

Version 1.0.5

December 29, 2025
  • Trade Tracking System: Mark trades complete and track your trading history
  • Click on cards in "You can give them" section to mark trades complete with optional notes
  • See "Pending" status on trades waiting for recipient confirmation
  • Confirm receipt of cards you receive with one-click confirmation
  • View all trades (given and received) in organized sections on each partner's match card
  • Undo pending trades if needed (before recipient confirms)
  • See "Confirmed" badge on completed trades that cannot be undone
  • Filter out already-traded cards from available matches to prevent duplicates
  • Track trade status: completed (pending), confirmed, or cancelled
  • Visual indicators show pending trades with clock icon (⏳) and confirmed trades with checkmark (✓)

Version 1.0.4

December 28, 2025
  • Friend Request System: Track in-game friendships with trading partners
  • Send friend requests directly from match cards with "Sent Friend Request" button
  • Mark existing friendships with "Already friends? Click here" option
  • Confirm or decline incoming friend requests with "I Accepted" and "Decline" buttons
  • See "Friends ✓" badge on match cards for confirmed friendships
  • View friend status indicators: pending requests show "Request Sent - Waiting..."
  • Turbo Stream updates provide instant feedback without page reloads
  • Prevents duplicate requests and self-friending
  • Bidirectional friendship tracking ensures both users see consistent status

Version 1.0.3

December 26, 2025
  • Smart Empty States: Matches page now shows context-aware messages based on your inventory status
  • New users see "Set up your inventory" prompt with clear call-to-action
  • Users with inventory see "No matches yet" with inventory summary and encouraging message
  • Empty states include email verification status and helpful next steps
  • Email Verification Guard: Unverified users receive verification reminder emails instead of full match details (privacy protection)
  • Reminder emails show match count without revealing partner information
  • Smart Redirects: After email verification, automatically redirected to matches page if you have matches waiting
  • Enhanced Email Digest: Now shows cards you can give to others, not just cards you can receive
  • Email organized into three sections: ✨ Mutual Trades, 📥 Cards You Can Receive, 📤 Cards You Can Give
  • Mutual trades show both what you can receive AND what you can give in a side-by-side layout
  • All sections now include star ratings for cards
  • Subject line highlights mutual matches when present

Version 1.0.2

December 24, 2025 🎄
  • Daily Email Digest: Receive daily emails when you have new matches
  • Email shows partner names, friend codes, and cards they can share
  • Mutual trades marked with ✨ and one-way matches with 🎁
  • Cards listed one per line for better readability
  • Emails sent daily at 10 AM PST (only when you have new matches)
  • Improved match badge styling on web and in emails

Version 1.0.1

December 22, 2025
  • Fixed mobile navigation menu with slide-out drawer
  • Improved mobile layout on matches page
  • Added card set names to match cards
  • Added match type explanation (mutual vs one-way)
  • Added match notifications banner on dashboard
  • Created FAQ page with roadmap and changelog

Version 1.0.0

December 21, 2025
  • Initial launch - Card inventory tracking
  • Automatic match finding engine
  • Match dashboard with friend code copying
  • Mobile-responsive design
  • User authentication and profiles