波波中文 · Bobo Hanzi Sprint
A game for learning Traditional Chinese: 時代華語 1, Lessons 1–6, the teacher's TOCFL vocabulary table (804 words),
writing practice, listening, and teacher-style tests, with an adaptive Smart review that notices what you still mix up.
It runs in any browser on a phone or a computer. Progress is saved in the browser. To move it to another device, use
我的 Me → 存檔 Save → Copy backup code, then Restore on the other device.
Run it
The site is plain static files in public/. To preview it on your computer:
python -m http.server -d public 8765
# open http://localhost:8765
Deploy (free)
- Put this folder in a GitHub repository.
- On vercel.com (Hobby plan), choose Add New → Project, import the repository and click Deploy.
vercel.json already tells Vercel to serve public/ with no build step.
- From then on, every push to
main updates the live site. Other branches get preview links.
Change it
Open the repository in Claude Code (claude.ai/code) and describe the change. CLAUDE.md explains to Claude how the
project is built and tested, and which rules keep your saved progress safe.
To work on it yourself:
pip install -r scripts/requirements.txt
python scripts/build.py # after editing content/
python scripts/assemble.py # after editing src/
python tests/run_all.py --quick
Credits
- Stroke data: Hanzi Writer / hanzi-writer-data (Make Me a Hanzi; Arphic Public License).
- Pinyin: pypinyin.
- Course content follows 時代華語 1 and the class materials, for personal study.
