🧠 Type Master

A fast, responsive, and elegant typing practice web app built during the Masai School Diwali Break Project (October 2025).
Type Master helps users improve their typing speed, accuracy, and consistency — all wrapped in a beautiful, modern UI built with React and Tailwind CSS.

---

🚀 Live Demo

🔗 Click here to try Type Master

---

🧩 Features

• ⚡ Real-time Typing Test — Measures speed (WPM) and accuracy.
• 📊 Instant Result Summary — Displays results instantly after each test.
• 💡 Clean UI/UX — Built with modern, responsive design principles.
• 🎨 Custom Tailwind Styling — Consistent and minimal aesthetic.
• 🔁 Restart Anytime — Practice as much as you want, instantly reset.
• 📱 Fully Responsive — Works seamlessly across all devices.

---

🛠️ Tech Stack

Category	Technologies Used
Frontend Framework	React 19
Styling	Tailwind CSS 4
Build Tool	Vite 7
Linting	ESLint + React Hooks + React Refresh
Language	JavaScript (ESNext)

---

📁 Project Structure

Type-Master/
├── public/
│   └── logo.png               # Project logo
├── src/
│   ├── assets/                # Static assets
│   ├── components/            # Reusable UI components (Navbar, etc.)
│   ├── App.jsx                # Root component with typing logic
│   ├── App.css
│   ├── index.css
│   └── main.jsx               # Entry point
├── .gitignore
├── eslint.config.js
├── index.html
├── package.json
├── package-lock.json
├── vite.config.js
└── README.md

---

⚙️ Installation & Setup

Follow these steps to run the project locally:

1. Clone the Repository

git clone https://github.com/your-username/type-master.git

2. Navigate to the Project Directory

cd type-master

3. Install Dependencies

npm install

4. Start the Development Server

npm run dev

Then open http://localhost:5173 in your browser.

---

🧪 Build for Production

To generate a production build:

npm run build

Preview the production build locally:

npm run preview

---

📦 Dependencies

"dependencies": {
  "@tailwindcss/vite": "^4.1.16",
  "react": "^19.1.1",
  "react-dom": "^19.1.1",
  "tailwindcss": "^4.1.16"
}

---

🧑‍💻 Team Members

This project was collaboratively built during Masai School’s Diwali Break (Oct 2025) by:

Name	Role	GitHub
👨‍💻 Ankit Kumar	Logic & Performance	@Ankitk0101
👩‍💻 Rajesh Gupta	Full Stack Developer	@rajeshgupta-dev
👨‍💻 Ankit Gupta	Frontend Developer	@ankit-ai-lab

---

🌟 Future Enhancements

• 🧮 Add leaderboard for global WPM rankings
• 🗣️ Introduce audio feedback and typing sounds
• 🎯 Add customizable test lengths and difficulty modes
• 📊 Integrate user authentication and progress tracking

---

🪪 License

This project is licensed under the MIT License. Feel free to use and modify it for personal or educational purposes.

---

❤️ Acknowledgements

Special thanks to Masai School for providing the learning environment and motivation to build Type Master. We learned, collaborated, and coded this project with passion during the Diwali break!

---

“Practice makes perfect — and Type Master makes practice fun.”