A real-time, two-player twist on the classic Wordle game. Instead of everyone solving the same daily word, each player secretly chooses the word their opponent has to guess, turning a solo puzzle into a head-to-head duel where both players race simultaneously to solve their assigned word.
Both players guess simultaneously. Green, yellow, and gray feedback flips in live as each guess lands.
Player A creates a private room and gets a shareable room code.
Player B joins using that code.
Each player secretly selects a word for their opponent to solve.
Once both words are locked in, the round begins simultaneously for both players.
Each player gets up to six guesses (classic Wordle rules) to solve their assigned word.
Whoever guesses their word correctly first wins the round.
Bidirectional gameplay over Socket.io: room membership, word selection, guess history, and round state synchronized live between both clients.
Shareable, custom room codes let two players match up directly without a public lobby.
Six guesses, color-coded green/yellow/gray feedback, and correct handling of repeated letters based on letter frequency in the target word.
Watch your opponent's progress in real time as they work through their guesses.
Built-in chat for banter between rounds, plus a rematch flow that skips recreating a room.
Guesses and word selections are validated against a real English word list (dwyl/english-words) to block invalid entries.
words.txt), with a WORDS_FILE environment variable escape hatch to mount a custom word list without rebuilding.HEALTHCHECK directive polling the root endpoint for production-readiness, not just "make it run."