Skip to content

codewithdhruba01/TypeMaster

Repository files navigation

⚡Typing Master

Banner

A modern, feature-rich typing test application built with React and TypeScript. Test your typing speed and accuracy with customizable settings, real-time statistics, and professional-grade performance tracking.

Features

Test Modes

  • Time-based Tests: 30 seconds, 1 minute, 2 minutes, 5 minutes
  • Word-based Tests: 25, 50, 100, 200 words
  • Difficulty Levels: Easy, Medium, Hard with varying text complexity
  • Pause/Resume: Pause your test anytime and resume when ready

Real-time Statistics

  • WPM (Words Per Minute): Net typing speed after accounting for errors
  • Gross WPM: Raw typing speed without error penalties
  • Accuracy: Percentage of correctly typed characters
  • Live Progress: Visual progress bar showing test completion
  • Character Feedback: Real-time color-coded character validation

Professional UI/UX

  • Modern Design: Clean, professional interface with smooth animations
  • Responsive Layout: Optimized for desktop, tablet, and mobile devices
  • Visual Feedback: Color-coded text (green=correct, red=incorrect, blue=current)
  • Performance Levels: Automatic skill level classification (Novice to Expert)
  • Animated Statistics: Smooth transitions and hover effects

Customization Options

  • Flexible Settings: Easy-to-use settings panel
  • Multiple Text Samples: Varied content for each difficulty level
  • Test Configuration: Choose between time or word-based tests
  • Instant Reset: Quick restart functionality

🛠️ Technology Stack

  • Frontend Framework: React 18 with TypeScript
  • Styling: Tailwind CSS for modern, responsive design
  • Icons: Lucide React for beautiful, consistent icons
  • Build Tool: Vite for fast development and optimized builds
  • Code Quality: ESLint for code linting and best practices

📦 Installation

  1. Clone the repository

    git clone https://github.com/codewithdhruba01/TypeMaster.git
    cd typemaster
  2. Install dependencies

    npm install
  3. Start development server

    npm run dev
  4. Build for production

    npm run build

How to Use

Starting a Test

  1. Choose Settings: Click the "Settings" button to configure your test
  2. Select Mode: Choose between Time-based or Word-based tests
  3. Set Duration/Count: Pick your preferred time limit or word count
  4. Choose Difficulty: Select Easy, Medium, or Hard difficulty level
  5. Start Typing: Click in the input field and begin typing

During the Test

  • Real-time Feedback: See your progress with live WPM and accuracy updates
  • Visual Cues: Characters turn green (correct) or red (incorrect) as you type
  • Pause Option: Use the pause button if you need a break
  • Progress Tracking: Watch the progress bar fill as you complete the test

After Completion

  • Detailed Results: View comprehensive statistics including:
    • Net WPM and Gross WPM
    • Accuracy percentage
    • Total characters typed
    • Correct vs incorrect characters
    • Performance level classification
  • Try Again: Reset and start a new test with different settings

Performance Levels

The application automatically classifies your performance:

  • 🏆 Expert: 80+ WPM - Professional typing speed
  • ⚡ Advanced: 60-79 WPM - Above average typing skills
  • 🎯 Intermediate: 40-59 WPM - Good typing proficiency
  • ⚠️ Beginner: 20-39 WPM - Learning phase
  • 📚 Novice: <20 WPM - Starting to learn typing

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

Happy Typing!

Improve your typing skills with our professional typing test application. Track your progress, challenge yourself with different difficulty levels, and become a typing master!


⭐ If you find this project useful, please give it a star!

Built with ❤️ by Dhrubaraj Pati for developers

WebsiteGitHubTwitter

About

A modern, feature-rich typing test application

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published