TypeStake

TypeStake is a competitive web-based typing duel platform where users can challenge each other in real-time typing battles. The platform focuses on speed, accuracy, and fairness, making typing both fun and competitive. A money-based duel mode is planned and currently available via a waitlist.

---

🚀 Features

• ⚔️ Real-time Typing Duels – Head-to-head competitive typing battles
• 🧠 Skill-Based Matchmaking – Players are matched based on typing performance
• 🌍 Global Leaderboards – Track top performers across the platform
• 🕒 Recent Activity Feed – View recent matches and results
• ⏱️ Accurate WPM & Accuracy Metrics – Server-verified performance stats
• 🔐 Server-Side Validation – No client-side manipulation of results
• 🛡️ Anti-Cheat First Approach – Server-side protection implemented; client-side anti-cheat in progress
• 📱 Responsive & Modern UI – Optimized for desktop and mobile

---

🛠️ Tech Stack

• Frontend: React / Next.js
• Styling: Tailwind CSS, shadcn/ui
• Backend: Node.js, Express
• Real-time Communication: Socket.IO
• Database: MongoDB / PostgreSQL

---

🧩 Game Flow

1. User logs in to their account

2. User navigates to the Duel section

3. Player selects:

   • Duel mode
   • Desired time duration

4. System searches for another player with similar skill level and preferences

5. Once matched, a dedicated real-time room is created using Socket.IO

6. Both players receive the same text and countdown

7. Match begins simultaneously

8. Performance (WPM, accuracy) is calculated server-side

9. Results are finalized and reflected in:

   • Global leaderboards
   • Recent activity feed

---

⚠️ Disclaimer

TypeStake is a skill-based competitive platform. Real-money duels are not yet enabled and are planned for a future release via a waitlist. The project does not promote gambling and is being developed with fairness, transparency, and legal compliance in mind.

---

📈 Future Improvements

• Client-side anti-cheat system
• Ranked competitive seasons
• Tournament & bracket system
• Spectator mode
• Wallet & stake-based duels (waitlist only)

---

🤝 Contributing

Contributions are welcome!

1. Fork the repo
2. Create your feature branch (git checkout -b feature-name)
3. Commit your changes
4. Push to the branch
5. Open a Pull Request

---