Wordminal is a CLI-based (can run solely in the terminal) word guessing game inspired by Wordle, developed by three students for a collaborative Node.js project. The application challenges players to guess six-letter words within five attempts, using color-coded feedback to guide their guesses. It is built entirely with JavaScript and npm packages,
- Six-letter word puzzles - Increased challenge compared to traditional five-letter variant
- Multiple difficulty levels - Three distinct difficulty settings (Easy, Medium, Hard)
- Color-coded visual feedback - Real-time terminal output using Chalk library
- Strategic gameplay - Increased challenge by only having five guesses for attempt
- Persistent score tracking - MongoDB integration enables historical performance analysis
- Interactive menu system - Intuitive navigation using Inquirer prompts
- Replay functionality - Restart and difficulty adjustment options, choosing a different word each time
git clone https://github.com/Otloir/Wordminal.git
cd Wordminal
npm init -y
npm install chalk @inquirer/prompts figlet dotenv
npm install chalk
npm install @inquirer/prompts
npm install figlet
npm install dotenv
Create a .env file in the project root directory with the following configuration:
MONGO_URI=your_mongodb_connection_string
To start the game, type this command in your terminal:
node game.js
-
The application displays the Wordminal title screen
-
Instructions are presented explaining how the game works
-
Player confirms if they are ready to start
-
Player select their preferred difficulty level: Easy, Medium, or Hard
-
Player is given five attempts to identify the target six-letter word
-
Each guess is validated against the game dictionary
-
Invalid inputs (incorrect word length or numbers) are rejected without consuming an attempt
-
After each valid guess, the application provides color-coded feedback:
- Green - Letter is correct and in the correct position
- Yellow - Letter exists in the target word but in an incorrect position
- Gray - Letter does not exist in the target word
9.1. Victory condition: Player successfully deduces the target word
9.2. Loss condition: Player exhausts all five attempts without identifying the word
-
Game statistics are displayed, including the number of attempts used
-
Options are presented to restart the game and change the difficulty
Node.js - JavaScript runtime environment
MongoDB - NoSQL database for persistent data storage
Chalk - Terminal string styling and colorization
Inquirer - Interactive command-line user interface
Figlet - ASCII art text generator
dotenv - Environment variable configuration management
Original concept inspired by Wordle by Josh Wardle
This project is licensed under the MIT License.