Skip to content


Repository files navigation

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.


👉👉 Continue reading: Chengyu Wordle Is Not a Love Story 👈👈

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


A lot more Wordle clones here


Copyright and license

  • Wordle ©️ The New York Times Company
  • Everything else: MIT license