ZhuyinCat
HTML / CSS / JavaScriptZhuyinCat is a typing game for learning to type in zhuyin (注音, also called bopomofo), the phonetic alphabet used to type Mandarin in Taiwan, on computers and phones alike. The game teaches the standard zhuyin keyboard layout (大千) one key at a time, from the home row to full sentences.
It runs right in the browser, on a computer and on a phone too, with nothing to install. There is no need to turn on a zhuyin keyboard either: the game reads the physical position of the keys, whatever the keyboard layout (QWERTY, AZERTY…). On a phone, it shows its own on-screen zhuyin keyboard.
The game
- A map of 6 stages and 33 lessons: home row, top row, bottom row, numbers and tones, first words, then short sentences.
- Several kinds of lessons: new keys, reviews, syllables with their character shown above, words about daily life, Taiwan and food, and full sentences to type in one go, just like on a real zhuyin keyboard.
- An on-screen keyboard coloured by finger: the key to type lights up, along with the matching key on your keyboard and the finger to use.
- One to three stars per lesson based on speed (keys per minute) and accuracy, plus a list of keys to practise.
- A speed challenge: the keys you have learned fall faster and faster, and you have to type them before they reach the ground.
- Interface in French, English and Traditional Chinese, day and night themes, typewriter sounds, and progress saved in the browser (it can be exported to switch devices).
Under the hood
The game is a static site in HTML, CSS and JavaScript, with no framework and no build step, using Bootstrap 5 and the same theme as MiningCat. Keys are recognised by their physical code (KeyboardEvent.code), so you can play with any keyboard layout, with or without a zhuyin input method turned on.
Sounds are generated with the Web Audio API, without any audio file, and progress is stored in localStorage. The site is published on GitHub Pages by GitHub Actions.
Also works on phones, with nothing to install. The project is open-source, released under the AGPL-3.0 license.