Chengyu Wordle

Wordle, for Chinese idioms – 成语 (chéngyǔ)

Guess the idiom in 6 tries.

This is my attempt at recreating Wordle, made by Josh Wardle, from scratch.




This game is built with these wonderful technologies:


  • npm i – install dependencies
  • npm run dev – start a development server


  • “Unique” IDs are generated for every idiom. They are not 100% unique and are generated with shorthash2. I’ve tested using this and it’s definitely possible to get the same hash for different idioms, if it’s used to generate hashes for ALL idioms. Now it’s only used for high-frequency idioms (smaller list).
  • Generated “keys” for the keyboard are not guaranteed to be persistent for every idiom. They are dynamically generated based on the list of idioms. So if the list of idioms or the order of the idioms changes, the keys will change. This will affect the shared results with emojis (??⬜).
  • It’s possible to fork this and change all idioms.


⚠️ If you don’t want to be spoiled, avoid reading the data marked with ?SPOILERS?.

Raw data stored in data/.

Game data stored in game-data/ are processed by running npm run data, which produces two files:

  • all-idioms.txt – list of all idioms, one per line.
  • ?SPOILERS? game-idioms.csv – list of idioms to be used in the game, with assigned “unique” id. This list is mainly from THUOCL’s high-frequency idioms.


I play Wordle sometimes and thought that it’s pretty cool. Personally I don’t find the Wordle braggings useful. They kind of pollute the social media timelines (Facebook, Twitter) but at least they’re better than ads ??‍♂️.

Then, I came across few “forks” of Wordle:

I’m like, “Hey, that’s pretty cool, but maybe I could try something else?”.

One day, I tweeted:

Wordle, but for Chinese idioms.


This is timely, because Chinese New Year is coming up.

I looked up some data from the Googleverse and realised this is kind of doable. It’s actually a bit difficult for me to build this because I can’t actually read or write Chinese. But heck, who cares, buidling a game is fun.

Other attempts

Copyright and license

  • Wordle ©️ Josh Wardle
  • Everything else: MIT license