Skip to content

About

A fun, addictive NBA player guessing game built with React. Guess the mystery player using clues and smart stat feedback. Track your score, complete all players, and challenge yourself to a perfect run! ๐Ÿ€

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

ย 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

STATS ๐Ÿ€

An NBA player guessing game built with React

Test your NBA knowledge! Guess the mystery player using clues, stats, and smart feedback. Compete against your own high scores.

Features

  • Progressive Mode: Guess through a roster of 35 NBA stars
  • Smart Clues: 4 difficulty-based clues per player (Easy โ†’ Expert)
  • Detailed Feedback: Wrong guesses give team, position, height, and PPG comparisons
  • Scoring System: Earn up to 1000 points per player based on clues used and guesses needed
  • Persistent Progress: Your completed players and scores are saved locally
  • New Player Support: Automatically detects and adds new players
  • Confetti Celebrations for perfect runs and full completions
  • Share Results: Beautiful shareable text with score breakdown
  • Keyboard Shortcuts (R = Reveal clue)
  • Responsive Design with Tailwind CSS and Lucide icons
  • Streak Counter and Support section (donations + feedback)

๐ŸŽฎ How to Play

  1. Guess the current NBA player by typing their name
  2. Wrong guesses reveal a new clue and provide stat comparisons
  3. Correct guess moves you to the next player with bonus scoring
  4. You have 6 guesses for the whole game
  5. Complete all players to achieve the highest possible score!

Pro Tip: Pay attention to the feedback โ€” it helps narrow down the player significantly.

๐Ÿ›  Tech Stack

  • React 18 with Hooks
  • Tailwind CSS for styling
  • Lucide React icons
  • LocalStorage for persistence
  • Vanilla JavaScript animations and confetti

๐Ÿ”ง Customization

  • Add players: Edit data/players.js
  • Change max guesses: Modify maxGuesses in App.jsx
  • Styling: Update Tailwind classes throughout components

๐Ÿ“ Future Ideas

  • Leaderboards (local or cloud)
  • Multiple difficulty modes
  • Mobile PWA support
  • Sound effects and enhanced animations
  • Daily challenge + weekly/all-time leaderboards

๐Ÿค Support

Enjoying the game? support always appreciated!

  • USDC (BEP20): 0x66D3D43e4603acfD9D74E89A68647946a93C2EAd

Every contribution helps keep the game growing with new players and features!

๐Ÿ“„ License

MIT License โ€” feel free to use, modify, and share.

About

A fun, addictive NBA player guessing game built with React. Guess the mystery player using clues and smart stat feedback. Track your score, complete all players, and challenge yourself to a perfect run! ๐Ÿ€

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages