# Keyboard Arena

> Keyboard Arena is a free, high-performance touch typing platform with real-time WPM speed tests, mechanical keyboard audio synthesis, A-Z finger biomechanics training, 40+ structured curriculum lessons, ghost rhythm pacing, and competitive arcade typing games.

## Core Features

- **Typing Speed Test**: Real-time Words Per Minute (WPM) and Raw WPM calculation with accuracy tracking, consistency standard deviation, and detailed keystroke analytics
- **Ghost Mode Pacer**: A live rhythm cursor that moves at your personal best or a target WPM speed, providing visual feedback to pace your typing
- **Mechanical Switch Audio Engine**: Web Audio API-powered sound synthesis with realistic Cherry MX Blue, Cherry MX Brown, Thock, Creamy, Holy Panda, Typewriter, and Silent themes
- **A-Z Finger Biomechanics Training**: Interactive hand visualizers showing correct finger-to-key assignments for all 26 letters, with isolation drills and muscle memory exercises
- **Structured Curriculum (40+ Lessons)**: Step-by-step touch typing course covering home row, top row, bottom row, numbers, punctuation, symbols, and code syntax
- **Typing Arcade Games**: Grand Prix (AI racing), Falling Words, and Survival Rush competitive modes
- **Deep Typing Analytics**: Keystroke heatmaps, per-key accuracy breakdown, WPM over time graphs, consistency metrics, and historical performance tracking
- **Zen Mode**: Distraction-free typing with minimal UI
- **Achievements & Leaderboard**: XP system, milestone badges, and global rankings

## Sections

- [Home](https://keyboard-arena.ytools.in/): Landing page with feature overview and daily challenge
- [Typing Test](https://keyboard-arena.ytools.in/#test): Core WPM speed test with ghost pacing and sound engine
- [Finger Practice](https://keyboard-arena.ytools.in/#finger-practice): A-Z biomechanics drills with hand visualizer
- [Lessons](https://keyboard-arena.ytools.in/#lessons): 40+ structured curriculum lessons
- [Grand Prix](https://keyboard-arena.ytools.in/#race): AI typing race game
- [Falling Words](https://keyboard-arena.ytools.in/#falling): Arcade reflex typing game
- [Survival Rush](https://keyboard-arena.ytools.in/#survival): Sudden death endurance typing
- [Statistics](https://keyboard-arena.ytools.in/#stats): Telemetry, heatmaps, and analytics
- [Achievements](https://keyboard-arena.ytools.in/#achievements): Badges, XP, and milestones
- [Leaderboard](https://keyboard-arena.ytools.in/#leaderboard): Global rankings and hall of fame
- [Settings](https://keyboard-arena.ytools.in/#settings): Audio themes, caret styles, and accessibility options

## Technical Details

- Built with React 19, TypeScript, Vite, and Tailwind CSS
- Web Audio API for low-latency mechanical switch sound synthesis
- Client-side storage for user statistics and progress
- Progressive Web App (PWA) support with offline capability
- Fully responsive design for desktop and mobile
- Zero server-side user data collection — all analytics are local

## Optional

- [Full Documentation](https://keyboard-arena.ytools.in/llms-full.txt)