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.



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.

Media coverage



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.


  • English: ./i18n/en.json
  • 中文: ./i18n/zh-CN.json

As of now, 中文 is very roughly translated from English via Google Translate, which may not be great. Help is needed for translations!

Other similar attempts

猜成语 (Cāi chéngyǔ) by @nurupo_dev – Guess the idiom

拼成语 | Chinese Wordle by Allan Chain

拼音猜成语 (Pīnyīn cāi chéngyǔ) by limboy

汉兜 (Hàn dōu) by Anthony & Inès

Telegram @unofficial_wordle_bot by Oh Chin Yang

疯狂猜成语安卓版 (Fēngkuáng cāi chéngyǔ ānzhuō bǎn) – Android game called “Crazy Guess Idioms”.


A lot more Wordle clones here


Copyright and license

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


View Github