⌨️ Typing Speed Tester (Flask)

A modern and interactive Typing Speed Test web app built using Flask, HTML, CSS, and JavaScript.
Test your typing speed, accuracy, and performance with a clean UI and real-time feedback.

---

🚀 Features

• 📝 Random typing passages (API-based)
• ⏱ Multiple time modes (15s, 30s, 60s, 120s)
• 📊 Live stats:
  • WPM (Words Per Minute)
  • Accuracy
  • Errors
  • Time elapsed & remaining
• 🎯 Real-time character highlighting
  • 🟢 Correct letters
  • 🔴 Incorrect letters
• 📉 Progress bar
• ⏳ Animated countdown timer
• 🏆 Final result modal with ranking system
• 🔁 Retry same passage or start new test
• ⌨️ Press Tab to restart instantly

---

🛠️ Tech Stack

• Backend: Python (Flask)
• Frontend: HTML, CSS, JavaScript
• Fonts: Google Fonts (Syne, JetBrains Mono)

---

📁 Project Structure

typing-speed-tester/ │ ├── app.py ├── templates/ │ └── index.html └── README.md

---

▶️ How to Run Locally

1. Clone the repository

git clone https://github.com/your-username/typing-speed-tester.git
cd typing-speed-tester

2. Install dependencies

pip install flask

3. Run the application

python app.py

4. Open in browser

http://127.0.0.1:5000/

---

🎮 How to Use

1. Select a time mode (15s / 30s / 60s / 120s)
2. Click on the input box and start typing
3. Timer starts automatically on first keystroke
4. Track your performance in real-time
5. View final results and ranking after completion

---

🏆 Ranking System

WPM Range	Rank
< 20	🐢 Beginner
20–40	🚶 Average
40–60	🏃 Good
60–80	⚡ Fast
80–100	🚀 Expert
100+	👑 Elite

---

📌 Future Improvements

• 🌐 Deploy online (Render / Railway)
• 💾 Save scores (database)
• 👤 User login system
• 📊 Leaderboard
• 🎨 Light/Dark theme toggle

This project is open-source and free to use.

---

👩‍💻 Author

Prathiksha