[docs] Create QR-based Minting and Auth System

[hasjack]

Design and document implementation of QR-based minting and authentication system using Coinbase's AgentKit tools

Key Areas

1. QR Code System

   • Dynamic QR code generation and positioning
   • Mobile-to-desktop flow with paddock preview
   • Smart spotlight effects for QR visibility
   • Responsive layout based on viewing distance

2. River Flow Integration

   • Water shader effects for authentication
   • Horse reflection system
   • Ripple animations for state changes
   • Particle system for celebrations

3. Payment Integration

   • Coinbase Onramp with Apple Pay
   • Payment confirmation animations
   • Seamless return to desktop flow
   • Progressive enhancement fallbacks

4. Visual Feedback System

   • State-based water effects
   • Consistent paddock styling
   • Smooth transitions and animations
   • Mobile-desktop coordination

Deliverables

• Component system documentation
• Water shader specifications
• Animation and transition guides
• Integration architecture
• User flow diagrams
• Testing strategy

This system will create a magical experience where minting and authentication feel like natural interactions with the Paddock components, while leveraging Coinbase's tools for secure transactions.