mlh-typing-metrics

Typing Speed Test App

🚀 A minimal & beautiful typing speed test web app created for the MLH Data Hackfest 2025.
Track your WPM (Words Per Minute), typing accuracy, and overall performance — all in real-time!

---

🌟 Features

• Clean and modern UI
• Real-time speed and word counter
• Accuracy calculation
• Result summary page
• Settings panel (basic)
• Responsive layout (desktop/mobile)
• Built-in timer

---

🛠️ Built With

• Python (Flask)
• HTML5, CSS3, JavaScript
• Jinja2 template engine
• VS Code & PyCharm
• ChatGPT (OpenAI) for planning and code support

---

🧠 How It Works

1. Visit homepage → Click Start Test
2. Type the paragraph shown within time
3. See result: Speed, Word Count, Accuracy
4. Navigate to settings (optional)

---

🎬 Demo Video

📺 Watch here: YouTube Demo

---

🧪 Try It Out

Currently, this app runs locally.
To test it on your machine:

🔧 Local Setup

```bash git clone https://github.com/ShreejitPodder/typing-speed-test.git cd typing-speed-test pip install -r requirements.txt python app.py Open your browser and go to: http://127.0.0.1:5000/

📁 Project Structure cpp Copy code typing-speed-test/ ├── static/ │ ├── style.css │ └── logo.png ├── templates/ │ ├── index.html │ └── result.html ├── app.py ├── requirements.txt ├── Procfile ├── .gitignore └── README.md ⚠️ Known Issues Accuracy percentage may slightly vary depending on typing edge cases

Settings panel is basic (further customization in progress)

👨‍💻 Created by Shreejit Podder for MLH Data Hackfest 2025 Devpost Profile

🤖 AI Contribution Some parts of this project — especially Flask backend logic, HTML templating, and design planning — were assisted using ChatGPT by OpenAI.

📜 License This project is licensed under the MIT License — feel free to fork & build more!

yaml Copy code MIT License © 2025 Shreejit Podder 🔗 GitHub Repo https://podderinstitutebd.github.io/mlh-typing-metrics/

This site is open source. Improve this page.