How I Built a Wordle for Chinese Idioms with 7,200+ Words, Pinyin & Audio (and achieved a 100 Lighthouse score)
Description and use
EasyIdiom is a free Wordle‑style puzzle game for Chinese idioms. It uses Preact, pinyin-pro, and a dynamic keyboard to provide character and pronunciation feedback. Performance optimizations and deferred third‑party scripts give it a 100/100 Lighthouse score and fast mobile operation.
Problem
Adapting Wordle to Chinese idioms required handling non-alphabetic characters, pronunciation (pinyin), and providing meaningful feedback without spoiling the game.
Outcome
EasyIdiom achieved a 100 Lighthouse score, runs offline on mobile, and provides a rich learning experience with pinyin and cultural hints.
Workflow
- 1. Build a lightweight frontend with Preact + Vite.
- 2. Use pinyin-pro to generate tones and handle polyphones.
- 3. Implement a virtual keyboard that highlights character correctness (green/amber/gray).
- 4. Add progressive clues: definition, pinyin of first character, mystery character location.
- 5. Optimize performance: replace heavy polyfills, split code with dynamic imports, defer third‑party trackers until first interaction.
- 6. Deploy on Vercel CDN for zero cold starts.
- 7. Test on mobile and desktop to confirm 100 Lighthouse score.
Evidence
achieved a flawless 100/100 Core Web Vitals score on Mobile & Desktop.
We built an interactive virtual keyboard that aggregates pinyin initials and finals dynamically based on candidate idioms, highlighting…
By auditing JavaScript chunks… deferred third‑party trackers until first user interaction…
- Record date: 2026-09-11T04:15:31.970Z