kinetic-cricket

byAryan jaiswara

MASTER PROMPT Build a production-ready mobile and web application called GullyScore Pro. The app is inspired by Cricbuzz, Crex, CricHeroes, and Cricheroes but specifically designed for street cricket, colony cricket, school cricket, society tournaments, hostel cricket, and local tournaments. The primary goal is: "Make score manipulation and cheating almost impossible." The application must be scalable, deployment-ready, modern, and suitable for thousands of concurrent matches. TECH STACK Frontend: Next.js 15 TypeScript Tailwind CSS Shadcn UI Framer Motion Backend: Node.js Express PostgreSQL Prisma ORM Realtime: Socket.io Authentication: Firebase Auth Google Login Phone OTP Login Storage: Cloudinary Deployment: Vercel (Frontend) Railway / Render (Backend) Neon PostgreSQL CORE FEATURES Live Scoring Like Cricbuzz. Support: 5 overs 6 overs 10 overs 15 overs Custom overs Ball-by-ball scoring. Runs: 0 1 2 3 4 5 6 Extras: Wide No Ball Bye Leg Bye Wickets: Bowled Caught Run Out Hit Wicket Retired ANTI-CHEATING SYSTEM This is the app's USP. Dual Team Verification Every match has: Team A Scorer Team B Scorer When a ball is entered: Ball becomes: "PENDING" Opponent must confirm. Only after confirmation: Ball becomes official. Dispute Mode If scorer enters: 6 Opponent says: 2 System opens dispute. Both teams vote. Spectators vote. Captain vote gets higher weight. Final result stored permanently. Ball Lock System After 30 seconds: Ball entry becomes immutable. No editing. Requires: Captain approval AND Opponent captain approval Match Audit Trail Every action recorded. Example: 8:05 PM Aryan added 4 runs 8:06 PM Rahul changed to 2 runs 8:06 PM Captain approved Permanent logs. Cannot be deleted. Video Proof Feature Players can upload: Last Ball Video Wicket Video Boundary Video Stored with timestamp. Used in disputes. AI Cheat Detection AI flags suspicious matches. Examples: 18 sixes in one over Score jumps Impossible run rate Fake players Same device controlling both teams Generate: Fair Play Score 0-100 GPS VALIDATION Prevent fake matches. Verify: Match location Team location Player location Show: Verified Match Badge QR MATCH JOINING Create Match Generate QR Players scan QR Join instantly. DIGITAL TOSS Spin animation. Random toss. Result locked. Cannot be edited. LIVE MATCH SCREEN Must look similar to Cricbuzz. Show: Current Score Overs Run Rate Required Run Rate Partnership Worm Graph Wickets Fall of Wickets Commentary Feed Live Updates AI COMMENTARY Automatically generate: Ball-by-ball commentary. Examples: "Massive six over long-on!" "Clean bowled! Stumps shattered." "Dot ball. Pressure building." Multiple commentary styles: Professional Funny Gully Hindi Hinglish AI HIGHLIGHTS Generate: Match Summary Player Summary Winning Moments Best Partnership Turning Point Automatically. PLAYER PROFILES Each player gets: Career Runs Career Wickets Strike Rate Economy MVP Awards Matches Played Win % Highest Score Best Bowling Batting Graph Bowling Graph TEAM FEATURES Team Logo Team Jersey Team Captain Squad Bench Statistics Ranking Achievements Trophies TOURNAMENT SYSTEM League Knockout Round Robin IPL Style World Cup Style Auction Style PLAYER AUCTION For local tournaments. Create auction. Player enters base price. Teams bid. Auction history stored. GULLY PREMIER LEAGUE MODE Season based. Points table. Orange Cap. Purple Cap. MVP Leaderboard. Fair Play Award. LEADERBOARDS Local Area School College City District State Country Global SOCIAL FEATURES Like Instagram for cricketers. Players can: Post photos Post videos Match updates Achievements Follow players Follow teams Comment Like Share REELS SYSTEM Cricket reels. Upload: Wickets Sixes Catches Run Outs Highlights AI VIDEO HIGHLIGHTS Automatically create: 30 sec reel 60 sec reel Tournament reel Winner reel Using uploaded clips. FAN MODE Spectators can: Watch live score React Vote in disputes Predict winner Earn points GAMIFICATION XP Levels Badges Achievements Coins Streaks Rewards MONETIZATION Premium Subscription Tournament Hosting Fees Ads Team Verification Player Verification Custom Jerseys Advanced Analytics Sponsor Pages ADMIN PANEL Manage: Users Teams Matches Tournaments Reports Disputes Videos Payments Leaderboards Analytics SECURITY JWT Rate Limiting Anti Spam Device Fingerprinting Role Based Access Audit Logs SQL Injection Protection XSS Protection CSRF Protection 2FA ANALYTICS DASHBOARD Daily Users Live Matches Completed Matches Revenue Retention Growth Heatmaps Fair Play Metrics UNIQUE FEATURES NOT IN CRICBUZZ Street Cricket Rules Engine Custom Rules: One Tip One Hand Direct Out Last Man Batting One Bounce Catch Roof Out Window Out Lost Ball Penalty Six and Out Custom Local Rules Noise Detection Use phone microphone. Crowd noise spike = likely boundary/wicket. Assist scoring. Smart Boundary Detection Use phone camera. AI detects: 4 6 Catch Wicket Gully DRS Players challenge decisions. Video replay. Community vote. Fair Play Rating Every player gets: Sportsmanship score. Street Cricket World Ranking Global ranking system for local players. UI REQUIREMENTS Modern Dark Mode Light Mode Responsive Cricbuzz inspired Apple-level polish 60 FPS animations Professional design system DELIVERABLES Generate: Complete folder structure Database schema Prisma models API routes Backend architecture Frontend architecture Authentication flow Realtime socket architecture CI/CD pipeline Docker setup Production deployment setup Testing strategy Scalability strategy Security strategy Full implementation code The output should be production-grade, scalable, maintainable, and ready for deployment.