🌐 Play the Game Now on website!
🌐 Play the Game Now on mobile!
📺 Watch 60-Second Gameplay Video
- ⚡ Fast-Paced Action - Click targets before they disappear!
- 📈 Dynamic Difficulty - Game speeds up as your score increases
- ⏱️ Timer System - Race against the countdown timer
- 🔥 Combo Streaks - Bonus points for consecutive quick hits
- 🎊 Smooth Animations - Buttery smooth target spawning and effects
- ✨ Particle Effects - Eye-catching animations on target hits
- 💫 Hover Glow Effects - Interactive visual feedback
- 🌈 Gradient Backgrounds - Beautiful animated gradient themes
- 📱 Responsive Design - Perfect on mobile, tablet, and desktop
- 🏆 Score System - Track current score and personal best
- 💾 LocalStorage Persistence - Your best scores are saved locally
- 📋 Mock Leaderboard - Compare with sample high scores
- 🎮 Game Controls - Start, Pause, Resume, and Restart functionality
| Technology | Purpose | Version |
|---|---|---|
| ⚛️ React | Frontend Framework | ^18.2.0 |
| ⚡ Vite | Build Tool & Dev Server | ^4.4.0 |
| 🎨 TailwindCSS | Utility-First Styling | ^3.3.0 |
| 🎭 Framer Motion | Animation Library | ^10.16.0 |
| 💾 LocalStorage | Data Persistence | Native Web API |
| 📱 Responsive Design | Mobile-First Approach | CSS Grid & Flexbox |
- Node.js (v16.0.0 or higher)
- npm or yarn package manager
# Clone the repository
git clone https://github.com/yourusername/reaction-speed-game.git
# Navigate to project directory
cd reaction-speed-game
# Install dependencies
npm install
# or
yarn install# Start development server
npm run dev
# or
yarn dev
# Open browser to http://localhost:5173# Create production build
npm run build
# or
yarn build
# Preview production build locally
npm run preview
# or
yarn preview- 🚀 Start Game - Click "Start Game" to begin
- 🎯 Click Targets - Hit the glowing targets before they disappear
- ⏸️ Pause/Resume - Use pause button to take breaks
- 🔄 Restart - Reset your current game anytime
- 🎯 Target Clicking: Click on targets as quickly as possible
- ⏰ Time Limit: You have limited time before targets disappear
- 📈 Difficulty Scaling: Game gets faster as your score increases
- 🔥 Combo System: Hit multiple targets quickly for bonus points
- 💔 Life System: Miss too many targets and it's game over!
- 🎯 Basic Hit: 10 points per target
- 🔥 Combo Bonus: +5 points per consecutive hit
- ⚡ Speed Bonus: Extra points for lightning-fast reactions
- 🏅 Best Score: Automatically saved to your browser
The game currently features a mock leaderboard with sample data to demonstrate the UI and functionality.
- 📊 JSON-based data - Static sample scores for demonstration
- 🎨 Professional UI - Clean, responsive leaderboard design
- 📱 Mobile-friendly - Optimized for all screen sizes
- 🌐 Real-time database integration (Firebase/Supabase)
- 👤 User authentication system
- 🏆 Global rankings with real player data
- 📈 Statistical analysis and player profiles
- 📱 Touch Sensitivity: Some mobile devices may have slight touch delay
- 🔊 No Audio: Sound effects not yet implemented
- 🌐 Offline Mode: Requires internet connection for optimal performance
- 💾 Local Storage Only: Scores stored locally (browser-specific)
- 🎮 Single Player: No multiplayer functionality yet
- 📊 Mock Data: Leaderboard uses sample data
- 🔊 Sound Effects - Hit sounds, background music, UI audio
- 🎶 Dynamic Soundtrack - Music that adapts to game intensity
- 🔇 Audio Controls - Volume sliders and mute options
- 🎨 Multiple Shapes - Circles, squares, triangles with different point values
- 🌈 Color Themes - Customizable visual themes
- 🎮 Game Modes - Endless, Time Attack, Survival modes
- ⚡ Power-ups - Slow motion, double points, extra time
- 👥 Multiplayer Mode - Real-time competitive gameplay
- 🏆 Global Leaderboards - Worldwide ranking system
- 🤝 Social Sharing - Share scores on social media
- 👤 User Profiles - Account system with statistics
- 📈 Detailed Statistics - Reaction time analysis, accuracy metrics
- 📋 Achievement System - Unlockable badges and rewards
- 📊 Progress Tracking - Historical performance data
We welcome contributions from the community! Here's how you can help:
- 🍴 Fork the repository
- 📥 Clone your fork locally
- 🌿 Create a feature branch:
git checkout -b feature/amazing-feature - 💻 Code your improvements
- ✅ Test thoroughly
- 📝 Commit with clear messages:
git commit -m 'Add amazing feature' - 📤 Push to your branch:
git push origin feature/amazing-feature - 📬 Submit a Pull Request
- 🧹 Code Quality: Follow existing code style and conventions
- 📖 Documentation: Update README and code comments as needed
- 🧪 Testing: Ensure all features work across different devices
- 📱 Responsiveness: Test on mobile, tablet, and desktop
- ♿ Accessibility: Consider accessibility in new features
Found a bug? Please create an issue with:
- 📝 Clear description of the problem
- 🔄 Steps to reproduce the issue
- 🖥️ Browser/device information
- 📸 Screenshots if applicable
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License - Copyright (c) 2024 Reaction Speed Game
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software.
Your Name
- 🌐 Website: yourwebsite.com
- 📧 Email: abhisheksangule6@example.com
- 🐙 GitHub: @yourusername
- ⚛️ React Team - For the amazing framework
- 🎨 TailwindCSS - For the utility-first CSS framework
- 🎭 Framer Motion - For smooth, powerful animations
- ⚡ Vite Team - For the lightning-fast build tool
- 🎮 Game Design Inspiration - Classic reaction time games
⭐ Star this repo if you found it helpful! ⭐
🎯 Play Now | 📖 Documentation | 🐛 Report Bug | 💡 Request Feature