TypeMaster is a comprehensive, feature-rich typing speed test application designed to help users improve their typing skills through various game modes, real-time analytics, and personalized feedback. Built with vanilla JavaScript and Firebase, it offers a modern, responsive interface with multiple customization options.
- Timed Test - Race against the clock (30s, 60s, 2min, 5min, or custom)
- Survival Mode - Continue until max mistakes or time runs out
- AI Practice - Personalized practice based on your weaknesses
- Prediction Challenge - Type predicted text to improve flow
- Numbers Only - Practice typing numbers and special characters
- Curriculum - Structured lessons for systematic improvement
- Real-time Stats - WPM, accuracy, correct/incorrect words, keystrokes
- Progress Charts - Track improvement over time with Chart.js
- Typing Heatmap - Visual representation of key usage
- Error Analysis - Identify common mistakes and problem keys
- Character Accuracy - Detailed breakdown by character
- AI Performance Analysis - Intelligent insights and recommendations
- 6 Sound Types - Mechanical, Typewriter, ASMR, Soft, Clicky, Silent
- Volume Control - Adjustable from 0-100%
- Real-time Generation - Web Audio API (no external files)
- Zero Latency - Instant feedback on every keystroke
- 5 Color Themes - Light, Dark, Blue, Pink, Green
- 4 Font Options - Default, Monospace, Serif, Sans-Serif
- On-screen Keyboard - Visual feedback with key highlighting
- Difficulty Levels - Easy, Medium, Hard word lists
- Multiple Languages - English and Bangla support
- Achievement System - Unlock badges based on performance
- Profile Tracking - Save progress with Firebase authentication
- Test History - Review all past tests and results
- Personal Records - Track your best performances
- Firebase Auth - Secure login/signup system
- Google Sign-in - Quick authentication with Google
- Profile Management - Track stats across devices
- Data Persistence - Cloud-based storage with Firestore
- Modern web browser (Chrome, Firefox, Safari, Edge)
- Internet connection (for Firebase features)
- No installation required!
- Clone or Download the repository
- Open
index.htmlin your web browser - Start typing - The test begins automatically!
# Clone the repository
git clone https://github.com/yourusername/typemaster.git
# Navigate to project directory
cd typemaster
# Open in browser
start index.html # Windows
open index.html # macOS
xdg-open index.html # LinuxTypeMaster/
├── index.html # Main HTML file
├── styles.css # All styling and themes
├── script.js # Core application logic
├── README.md # This file
├── FEATURES.md # Detailed feature documentation
├── USER_GUIDE.md # User instructions
├── DEVELOPER_GUIDE.md # Developer documentation
├── API_REFERENCE.md # Code API reference
├── CHANGELOG.md # Version history
├── CONTRIBUTING.md # Contribution guidelines
├── LICENSE.md # License information
└── TROUBLESHOOTING.md # Common issues and solutions
- Select Game Mode - Choose from 6 different modes
- Adjust Settings - Configure time, difficulty, language, sounds
- Click Start or just start typing
- View Results - Get detailed analysis after completion
- Tab - Start/Restart test
- Escape - Stop current test
- Just start typing - Auto-starts the test
- Focus on accuracy first, speed will follow
- Use proper finger placement on home row
- Practice regularly for consistent improvement
- Take breaks to avoid fatigue
- Try different game modes to stay engaged
- HTML5 - Semantic markup
- CSS3 - Modern styling with CSS variables
- JavaScript (ES6+) - Vanilla JS, no frameworks
- Firebase Authentication - User management
- Cloud Firestore - Data storage
- Firebase Hosting - Deployment (optional)
- Chart.js - Data visualization
- Font Awesome - Icons
- Web Audio API - Keyboard sounds
TypeMaster includes 5 beautiful themes:
- Light - Clean, bright interface (default)
- Dark - Easy on the eyes for night typing
- Blue - Professional blue color scheme
- Pink - Vibrant pink aesthetic
- Green - Calming green tones
| Browser | Version | Support |
|---|---|---|
| Chrome | 90+ | ✅ Full |
| Firefox | 88+ | ✅ Full |
| Safari | 14+ | ✅ Full |
| Edge | 90+ | ✅ Full |
| Opera | 76+ | ✅ Full |
TypeMaster is fully responsive and works on:
- 💻 Desktop computers
- 💻 Laptops
- 📱 Tablets
- 📱 Mobile phones
- User data is stored securely in Firebase
- Passwords are hashed and never stored in plain text
- Google Sign-in uses OAuth 2.0
- No personal data is sold to third parties
- See
PRIVACY.mdfor full privacy policy
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
- 🐛 Report bugs
- 💡 Suggest new features
- 📝 Improve documentation
- 🔧 Submit pull requests
- 🌍 Add translations
This project is licensed under the MIT License - see LICENSE.md for details.
Taafeef Bin Montaquim
- Portfolio: [Your Portfolio URL]
- GitHub: [Your GitHub]
- LinkedIn: [Your LinkedIn]
- Chart.js for beautiful data visualization
- Firebase for backend infrastructure
- Font Awesome for icons
- The typing community for inspiration
Need help? Found a bug?
- 📧 Email: [montaquim.tbm@gmail.com]
- 🐛 Issues: GitHub Issues
- 💬 Discussions: GitHub Discussions
- Multiplayer racing mode
- Global leaderboards
- Custom text import
- Mobile app (iOS/Android)
- More languages
- Advanced statistics
- Team/organization features
- Typing certificates
If you find TypeMaster useful, please consider giving it a star on GitHub!
Made with ❤️ by Taafeef Bin Montaquim
Happy Typing! ⌨️✨