RiftSnap - Riftbound Card Collection App

Application Overview

RiftSnap is a mobile application designed to help Riftbound players collaborate, share collections, and plan decks together. The app enables users to:

Build Friend Network: Add friends by nickname, send/receive friend requests, manage your friend list
Share Collections: Share your card collection with specific friends to showcase what you own and make trades
View Friend Collections: See exactly what cards your friends own, their pricing, and availability
Borrow Cards for Decks: Select cards from friends' collections to test deck strategies before purchasing
Scan Cards: Use device camera with YOLO computer vision to instantly recognize Riftbound cards
Build & Analyze Decks: Create theoretical decks with friends, view analytics, and plan collaboratively
Track Prices: Monitor card market values and organize into collections and wishlists

Key Purpose

RiftSnap is a social card collection and collaborative deck planning tool. Its primary focus is enabling players to share collections with friends, borrow cards, and plan decks together. It does NOT simulate or automate Riftbound gameplay. Players still play the game manually and socially, and the app exists only to facilitate that social interaction around card collecting.

How It Works

Flow & architecture

User Flow

1. User Authentication: Players sign in using Clerk authentication with options for email, Google, Apple, or Discord.

2. Social Discovery: Search for and add friends by nickname, send/receive friend requests, build your friend network.

3. Card Scanning: Users point their device camera at a Riftbound card. The on-device YOLO model detects and identifies the card in real-time.

4. Collection Building: Recognized cards are added to the user's collection with quantity tracking and folder organization.

5. Collection Sharing: View friends' collections, see what cards they own, check pricing, and identify what you could borrow.

6. Collaborative Deck Building: Build decks together with friends, borrow cards from their collections, view deck analytics, and plan strategies.

7. Cloud Sync: Collections and decks sync to the cloud backend for cross-device access, sharing, and backup.

Technical Architecture

Mobile Frontend

Framework: Flutter (iOS, Android)
ML: YOLO v8 ONNX (on-device card detection)
Storage: Hive (local cache)

Backend API

Runtime: Cloudflare Workers
Database: Cloudflare D1 (SQLite)

Card Data Source

Official: Riot Games Riftbound API
Images: Direct from Riot API URLs
Updates: Synced on app launch

Authentication

Provider: Clerk
SSO: Google, Apple
Security: JWT tokens, HTTPS only

Compliance with Riot Games Policies

Compliance details (approved use, monetization, and restrictions)

✓ Approved Use Case

RiftSnap is a Card Collection & Deck Management Tool this is an explicitly approved use case per Riot's Riftbound Digital Tools Policy.

What We Do (Approved)

Friend System: Build social networks with other players via nickname-based friend requests and management
Collection Sharing: Share collections with specific friends to showcase owned cards and facilitate trading discussions
View Friends' Collections: Browse what cards your friends own, their pricing info, and availability for borrowing
Card Borrowing: Borrow specific cards from friends' collections to test deck strategies and combinations
Collaborative Deck Planning: Build and analyze decks together with friends using shared cards and borrowing system
Card Gallery: Display Riftbound cards from official Riot API with metadata and pricing
Deck Statistics: Provide analytics on deck composition (energy curves, power distribution, type breakdown)
Collection Organization: Categorize cards into folders and track personal preferences

Monetization Model

✓ Free Tier Available

Free Plan Includes:

Up to 400 cards in collection with full organization
Up to 4 deck lists with analytics
Up to 2 collection folders
Unlimited card scanning sessions
Scan history tracking

Premium Plan Includes (Social & Collaboration Features):

Unlimited Friends: Build and manage unlimited friend networks
Full Collection Sharing: Share collections with specific friends to show what you own
View Friends' Collections: Browse and see exactly what cards your friends own and their availability
Card Borrowing System: Borrow specific cards from friends' collections to test deck strategies
Unlimited cards in collection
Unlimited deck lists
Unlimited collection folders
Advanced collection organization
Priority support

Premium unlocks full social collaboration - connect with friends, share your collection, see what they own, and borrow cards for collaborative deck testing. These are transformative social tools that enable the core collaborative experience of the app, not just data access upgrades. The free tier is complete for solo collection management.

What We Don't Do (Prohibited)

❌ No Automated Gameplay: We do not simulate or enforce Riftbound rules

❌ No Skill Ranking: No leaderboards, MMR calculators, or player ranking systems

❌ No Metagame Analytics: We do not publish or track deck win rates, card play rates, or meta statistics

❌ No Betting/Gambling: No wagering or gambling mechanics

❌ No Unofficial Content: All cards sourced exclusively from official Riot API

❌ No Standalone Game Client: This is a collection tool, not a game platform

Asset Usage

All Riftbound card data and images are sourced from the official Riot Games Riftbound API. The app uses:

Official card art via API-provided image URLs
Official English card text from API
Official card metadata and rules text
No external, fan-made, or unofficial card data

Legal Disclaimers

The app displays the required Riot Games disclaimer in a prominent location:

"RiftSnap isn't endorsed by Riot Games and doesn't reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games, and all associated properties are trademarks or registered trademarks of Riot Games, Inc."

Platforms & Distribution

iOS & Android distribution

Supported Platforms

📱 iOS

via Apple App Store

🤖 Android

via Google Play Store

Availability

The app will be distributed through official app stores and will be available for download in all regions where Riftbound is officially supported.

User Privacy & Data

Data collection & security

Data Collection

RiftSnap collects the minimum necessary data to function:

User Identity: Email and username (via Clerk authentication)
Collections: Cards the user has added to their collection
Decks: Deck lists created by the user
Preferences: App settings and user preferences

Data Security

All data transmitted over HTTPS with encryption
Authentication via secure Clerk service
Rate limiting and security headers on all API endpoints
User data isolated per account with access controls
GDPR compliance with data deletion request support

Screenshots & Visual Overview

Below are actual screenshots from the RiftSnap mobile application. Navigate through each screen to see key features:

Live card scanning with real-time detection

Live Card Scanner

Real-Time Card Detection: Users point their camera at a physical card. The YOLO computer vision model instantly recognizes the card and displays information including card name, set code, and current market value. The session total tracks cumulative value of all cards scanned in the current session.

Review scanned cards with quantity controls

Scan Review & Quantity

Scan Review Screen: After scanning, users review detected cards with thumbnail preview, card name, set information, and unit price. Quantity can be adjusted with +/- controls. Cards can be saved to collections or discarded if incorrectly detected.

Scan History

Scan History: Comprehensive log of all scanning sessions with total scans count and cumulative value. Each session entry shows timestamp, number of cards found, and session value. Sessions marked with "New High" indicate peak value scans.

Card collection gallery with portfolio tracking

Your Collection

My Collection: Personal collection view displays portfolio value, total card count, and card gallery organized into folders. Search, filter, and organize cards into named binders. Wishlist tracks desired cards. Share your collection with friends to show what you have.

Friends' Collections (Premium)

View What Friends Own: Browse your friends' shared collections to see exactly what cards they have. Search through their inventory to find specific cards you can borrow for deck testing.

Deck Library & Analytics

Deck Builder: Users create and manage theoretical deck lists for planning physical gameplay. Advanced stats display energy curves, power distribution, card type breakdown, and domain composition. Borrow specific cards from friends to test deck ideas. This is purely a planning tool, it does NOT simulate gameplay.

Friend System & Social Hub

Friend Management: Search for friends by nickname, send/receive/manage friend requests. View all accepted friends and their shared collections. Access settings for foil effects and motion sensor controls. This is the social center where you manage relationships and collaborative deck building. No competitive features, purely social and organizational.

Key UI Observations

Social-First Design: Friend system, collection sharing, and borrowing are core navigation items
Transparent Collections: Easy visibility into what friends own, making collaborative planning seamless
Dark Mode Interface: Modern, card-focused design optimized for readability and extended use
Bottom Navigation: Five main sections prioritize: Collection, Scanner, History, Decks, Profile (social hub)
No Gameplay Elements: No turn timers, health counters, game boards, or match interfaces - purely organizational
Collaborative Focus: All features designed around collection sharing, friend discovery, and deck planning together
Market Integration: Card pricing and value tracking enabling trade discussions

Riot API Integration

API endpoints & rate limiting

API Endpoints to use

RiftSnap will integrate with Riot's official Riftbound API to fetch:

Card Catalog: Complete list of Riftbound cards with metadata
Card Images: Official card art URLs (thumbnails and full resolution)
Card Text: Official English text and rules information
Set Information: Riftbound set releases and updates

Rate Limiting Compliance

The app implements proper rate limiting:

Development environment respects 10 calls per 10 seconds limit
Production will use appropriate rate limiting for expected volume
Aggressive caching of card data to minimize API calls
Batch requests where possible to optimize API usage