implemented the Invite Friends Page

[nafiuishaaq]

✅ Complete Referral System Implementation

Main Features:

1. Invite Friends Page (/invite-friends)

   • 📊 Referral Statistics Dashboard - Shows total invites, active users, rewards earned, and XP gained
   • 🔗 Referral Link Section - Copy/share functionality with reward information
   • 👥 Invited Users List - Displays all invited friends with status and rewards
   • 🏆 Milestone Tracking - Progress towards next reward tier
   • �� Reward Tiers - Clear progression system (5, 10, 25, 50 invites)

2. Referral Landing Page (/ref/[referralId])

   • 🎯 Personalized Welcome - Shows referrer's profile and stats
   • ⭐ Special Bonuses - Highlights exclusive rewards for referred users
   • �� Game Preview - Overview of what awaits new users
   • �� Call-to-Action - Direct path to registration with bonuses

3. Reusable Components:

   • ReferralStats - Clean statistics display
   • ReferralLink - Link management with copy/share
   • ReferralCard - Individual user cards
   • ReferralNotification - Toast notifications for rewards

4. Custom Hook (useReferral)

   • State management for referral data
   • API integration functions
   • Utility functions for rewards and progress

5. API Routes:

   • GET /api/referrals/[userId] - Fetch referral data
   • POST /api/referrals/track - Track new referrals

6. Navigation Integration

   • Added "Invite Friends" link to main navbar
   • Accessible from any page

Reward System:

• Referrer Rewards: 5→Rare, 10→Epic, 25→Legendary, 50→Mythic NFTs
• Referred User Bonuses: Welcome NFT, 50 XP, Exclusive Badge
• Progress Tracking: Visual progress bars and milestone indicators

Technical Features:

• ✅ Responsive design with glass morphism effects
• ✅ Native sharing with clipboard fallback
• ✅ Status badges (Active, Pending, Inactive)
• ✅ XP tracking and reward visualization
• ✅ Modular component architecture
• ✅ Comprehensive documentation

The implementation follows the existing design system and integrates seamlessly with the NFT Scavenger Hunt theme. Users can now easily invite friends, track their referrals, and earn exclusive rewards while new users get special bonuses for joining through referrals!

closes #580