Abrom-code/amharic_typing

# 🇪🇹 Amharic Typing Trainer A professional, browser-based typing tutor for learning the Amharic (አማርኛ) Ethiopic script. Built with React 18, Vite, and Tailwind CSS, it guides learners from zero through mastery across five progressive difficulty levels — all without a backend. --- ## Features - **5 Progressive Levels** — Beginner → Elementary → Intermediate → Advanced → Expert - **65+ Structured Lessons** — Covers every Ethiopic fidel group, labialized sounds, numbers, words, sentences, and timed passages - **Locked Progression System** — Next level unlocks after completing 75% of the current level (100% required for Expert) - **Real-time Metrics** — Live WPM, Accuracy, and Timer during each lesson - **Ghost Text Display** — Character-by-character color feedback: green (correct), red (wrong), yellow (cursor) - **Virtual Keyboard** — On-screen Amharic keyboard highlights the active key in blue and flashes red on errors - **Per-character Letter Stats** — Tracks accuracy per Ethiopic character across sessions - **Session History** — Every completed lesson is stored with WPM, accuracy, and date - **Statistics Dashboard** — Charts (sessions, weekly, 30-day), alphabet proficiency heatmap, recent activity, and weak-spot suggestions - **Achievement Popups** — Animated toast notification on lesson completion - **Sound Effects** — Key press, error, and success sounds (place MP3s in `public/sounds/`) - **Persistent Progress** — All data saved in browser `localStorage` — no account needed --- ## Tech Stack | Tool | Purpose | |---|---| | React 18 | UI and state management | | Vite | Build tooling and dev server | | Tailwind CSS | Utility-first styling | | React Router v6 | Client-side routing | | Recharts | Statistics charts | | Lucide React | Icons | --- ## Installation ```bash # Clone the repo git clone github.com cd amharic_typing # Install dependencies npm install # Start development server npm run dev # Build for production …