Wordle CLI Workshop

This is a workshop where we, as a class, build a Wordle CLI clone in Node JS.

Learning Objectives

• Build a fully playable game from scratch, starting with nothing but an idea
• Locate and make use of NPM dependencies in a project
• Step through the process of breaking down a high-level idea into smaller, manageable units of functionality
• Get inspired to take ideas and build something cool

Requirements

• Split the cohort into groups of 3 to 4 people
• We start with an energiser where we play an actual game of Wordle (https://www.nytimes.com/games/wordle/index.html) - sourcing guesses from the class, and hopefully learning how the game works in the process
• Ensure the class understands the rules of the game first
• Then we start building out our Wordle CLI clone from scratch
  • Referencing steps from this README: https://github.com/CodeYourFuture/wordle-clone-example#readme (this example solution can be given to the trainees after the session has finished)
  • Steps 1 & 2 can be done together as a class. All the code here should be sourced from the trainees themselves - this is their implementation. However, the volunteer who is running the workshop can ensure the high-level problem is broken down into these smaller functions: getRandomWord, getGuess and showWordWithHighlights
  • Step 3 (getRandomWord) can be done in groups
  • Step 4 (getGuess) can be done in groups - but it might be useful for a volunteer to suggest which NPM dependency we could use
  • Step 5 (showWordWithHighlights) can be done in groups - again, we can suggest which NPM dependency to use
  • Step 6 (improving the user experience) could possibly be done as a class together

Acceptance Criteria

Given the user starts a new Wordle game When the app is initialized Then a random 5 letter word should be selected as the target word

Given the target word has been selected When the user enters a 5 letter guess Then the guess should be validated And each letter should be marked as green, yellow or gray based on whether it matches the target word

Given a valid 5 letter guess has been entered When the guess does not match the target word Then each letter should be marked as follows:

• Green if the letter is in the correct position
• Yellow if the letter is in the target but not in the correct position
• Gray if the letter is not in the target word

Given a guess has been submitted When the guess matches the target word Then a message should indicate the user has won the game

Given guesses have been submitted When the user reaches 6 guesses without matching the target word Then a message should indicate the user has lost and show the target word

• I understand the code I have written