A few months ago, I watched a video (in Spanish) about creating a Wordle using AI.
The video used OpenAI Codex to create a Wordle. It was developed by its amazing host Carlos Santana.
If you can understand Spanish I suggest you subscribe to learn amazing things. I had previously written an article on how to write a Wordle using TDD in January.
How to Develop a Wordle Game using TDD in 25 Minutes
I decided to replicate it and take my conclusions. So I followed the host's same instructions (translating them to English and adding my comments).
You can follow this step-by-step tutorial on the Codex Playground site. It is a pity Carlos's amazing tutorial is in Spanish, and English-speaking people miss it.
I will translate his steps into English.
Step by Step Creation
0. Setup
- Go to Opean AI Site
- Create an account if you hadn't done yet.
- GoTo Codex Javascript Sandbox
1. First Instruction (UI?)
/* create a table with 6 rows and 5 columns */
Output
/* create a table with 6 rows and 5 columns */
var table = document.createElement('table');
table.setAttribute('border','1');
for (var i = 0; i < 6; i++) {
var row = document.createElement('tr');
for (var j = 0; j < 5; j++) {
var cell = document.createElement('td');
cell.innerHTML = '<b>' + (i * 5 + j) + '</b>';
row.appendChild(cell);
}
table.appendChild(row);
}
document.body.appendChild(table);
This was unexpected.
A table is not an HTML Table.
Both the author and Javascript code generator think about visual elements.
What is more, variables have very bad names like i and j
We started with an abbreviation code smell.
2. Cells styling (UI)
/* Cells are grey, squared of 80px 80px */
/* Cells are grey, squared of 80px 80px */
var cells = table.getElementsByTagName('td');
for (var i = 0; i < cells.length; i++) {
cells[i].style.backgroundColor = '#ccc';
cells[i].style.width = '80px';
cells[i].style.height = '80px';
}
Moving on with accidental UI style definition, the generator stylized the cells
3. Cells are half size (UI)
/* cells are half size */
/* cells are half size */
for (var i = 0; i < cells.length; i++) {
cells[i].style.width = '40px';
cells[i].style.height = '40px';
}
Impressive. It has context and is aware meaning of halving.
4. No table borders (UI)
/* there are no borders */
/* there are no borders */
table.style.border = 'none';
5. Cells have no border (UI)
/* Cells have no border */
/* Cells have no border */
for (var i = 0; i < cells.length; i++) {
cells[i].style.border = 'none';
}
Notice we have 5 steps and we have no idea what is a Wordle, we are just playing around with the User Interface.
6. Text is centered (UI)
/* text is centered */
/* Text is centered */
for (var i = 0; i < cells.length; i++) {
cells[i].style.textAlign = 'center';
}
7. Text is white (UI)
/* text is white*/
/* text is white */
for (var i = 0; i < cells.length; i++) {
cells[i].style.color = 'white';
}
8. Text Styling (UI)
/* text is font Helvetica and bold */
/* text is font Helvetica and bold */
for (var i = 0; i < cells.length; i++) {
cells[i].style.fontFamily = 'Helvetica';
cells[i].style.fontWeight = 'bold';
}
Seriously? No actual game yet?
9. Cells have no padding (UI)
/* Cells have no padding */
/* cells have no padding */
for (var i = 0; i < cells.length; i++) {
cells[i].style.padding = '0px';
}
10. Cells are empty (UI/Model)
/* cells are empty */
/* cells are empty */
for (var i = 0; i < cells.length; i++) {
cells[i].innerHTML = '';
}
Following Carlos's Instructions, we arrived at a ready-to-use User Interface.
No tests, no business rules. yet.
11. Add an input field (UI/Model)
/* add an input text field under the table */
/* add an input text field under the table */
var input = document.createElement('input');
input.setAttribute('type','text');
input.setAttribute('placeholder','Write Something');
document.body.appendChild(input);
12. Style the input field (UI)
/* add margin reduce text field width to 100px */
/* add margin reduce text field width to 100px */
input.style.margin = '10px';
input.style.width = '100px';
13. Add validator with id (Model)
/* add a button by the field with the 'tick' character. The button must have an id named 'validate' */
/*add a button by the field with the 'tick' character. The Button must have un id named 'validate' */
var button = document.createElement('button');
button.innerHTML = '✓';
button.id = 'validate';
document.body.appendChild(button);
We think ahead knowing we will need an accidental and implementation id.
It is fine. As Carlos comments in his video, we need to
We are creating a button with a special identifier since we guess it might be useful later.
14. Add remover button with another id (Model)
/* add another button with id 'remove' and the 'x' character as label */
/* add another button with id 'remove' and the 'x' character as label */
var button = document.createElement('button');
button.innerHTML = '✗';
button.id = 'remove';
document.body.appendChild(button);
15. Center box text (UI)
/* Center box text */
/* center box text */
input.style.textAlign = 'center';
16. Limit the text size (UI/Model)
/* we cannot write more than 5 characters in the input field */
/* we cannot write more than 5 characters in the input field */
input.setAttribute('maxlength','5');
17. We need to store the current attempt (Model)
/* create variable named 'rowIndex' starting at 0 */
/* create variable named 'rowIndex' starting at 0 */
var rowIndex = 0;
This is when black magic comes in.
We need to think ahead.
There's surely a better place to program a wordle. Stay tuned!
18. Text in uppercase (Model)
/* when entering text in the box, convert it to uppercase */
/* when entering text in the box, convert it to uppercase */
input.addEventListener('keyup', function(event) {
event.target.value = event.target.value.toUpperCase();
});
19. We went ahead of time (...)
We need to rephrase the following instruction several times until we get the desired behavior.
We have immediate feedback, so we are happy.
20. Input text should be displayed on the cells (Model/UI)
/* after writing on the text field, the value from every character will be written on each cell of the selected row */
/* after writing on the text field,
the value from every character will be writen
on each cell of the selected row */
input.addEventListener('keyup', function(event) {
var text = event.target.value;
var cells = document.querySelectorAll('td');
for (var i = 0; i < cells.length; i++) {
if (i >= rowIndex * 5 && i < (rowIndex + 1) * 5) {
cells[i].innerHTML = text.charAt(i - rowIndex * 5);
}
}
});
21. We choose our secret word (Model)
/* store in a variable the secret word 'PAPER' */
/* store in a variable the secret word 'PAPER' */
var secretWord = 'PAPER';
22. If the character matches, put yellow (Model/UI)
/* When clicking the 'validate' button, we need to check if the characters of the chosen row are included in the secret word. If they are, the cell should be marked as yellow */
/* When clicking validate button,
we need to check if the characters of the chosen row
are included in the secret word.
If they are, the cell should be marked as yellow (#edc953) */
document.getElementById('validate').addEventListener('click', function(event) {
var cells = document.querySelectorAll('td');
for (var i = 0; i < cells.length; i++) {
if (i >= rowIndex * 5 && i < (rowIndex + 1) * 5) {
if (secretWord.indexOf(cells[i].innerHTML) >= 0) {
cells[i].style.backgroundColor = '#edc953';
}
}
}
});
23. If the character matches, then put green (Model/UI)
/* if character is in right position, cell should be in green (#a9e54e) */
// Step 23
// if character is in right position, cell should be in green (#aedb95)
document.getElementById('validate').addEventListener('click', function(event) {
for (var i = 0; i < cells.length; i++) {
if (i >= rowIndex * 5 && i < (rowIndex + 1) * 5) {
if (secretWord.charAt(i - rowIndex * 5) === cells[i].innerHTML) {
cells[i].style.backgroundColor = '#aedb95';
}
}
}
});
24. Moving to the next Row (Model)
/*when clicking validate button, rowIndex variable increases */
/* when clicking validate button, rowIndex variable increases */
document.getElementById('validate').addEventListener('click', function(event) {
rowIndex++;
});
25. Erasing game (Model)
/* when clicking validate button, rowIndex variable increases */
// Step 25
// when pushing remove button, every letter is erased, rowIndex goes to 0 and all cells turn gray
document.getElementById('remove').addEventListener('click', function(event) {
var cells = document.querySelectorAll('td');
for (var i = 0; i < cells.length; i++) {
cells[i].innerHTML = '';
cells[i].style.backgroundColor = '#ccc';
}
rowIndex = 0;
});
26. Saving valid words (Model)
/* save a collection of the following words: tools, super, faker, catch, cried in uppercase */
// Step 26
/* save a collection of the following words: tools, super, faker, catch, cried in uppercase */
var words = ['TOOLS', 'SUPER', 'FAKER', 'CATCH', 'CRIED'];
27. Choosing a secret word (Model)
/* when pressing remove, chose randomly the secret word from the words collection */
// Step 27
/* when pressing remove, chose randomly the secret word from the words collection */
document.getElementById('remove').addEventListener('click', function(event) {
var randomIndex = Math.floor(Math.random() * words.length);
secretWord = words[randomIndex];
});
The End is near
Up to here, I stuck to Carlos's demo.
There are some missing functionalities:
-- Business rules:
- Game should start with a random word.
- Words outside the dictionary should be invalid. Therefore, words with lengths different than 5 will not be available.
- The end of the game when we win or lose.
- We need to use a real dictionary.
-- UI / UX:
- The on-screen keyboard.
- The letters flipping.
- After entering the world, the text box should be cleared.
-- Extra:
- Wordle sharing characters
⬛⬛⬛🟩🟩
🟨⬛⬛⬛⬛
⬛⬛⬛🟩🟩
⬛🟨🟨🟨⬛
🟩🟩🟩🟩🟩
- ... many more to come ...
Conclusion
Of the 27 steps above, 22 are related to UI.
The model might not survive many business changes.
Maybe the TDD version does.
The technology is amazing.
We can build an entire User Interface providing natural language commands.
Stay tuned for Wordle evolution on the following articles.
Credits
Image by DALL-E
Original video here
Full Source code on GitHub here.
Working version (not fully functional as mentioned above) here
Also published here.