wordle-clone

Open App

Flask Python SQLite HTML5 CSS3 Animations JavaScript App Hub Shared Backend

word-game puzzle vocabulary brain-teaser daily-challenge statistics streaks

Wordle Clone 🎮

A beautiful, self-contained Wordle-style word guessing game for the ily.dog platform.

!Wordle Clone !Version

🎯 About

Guess the 5-letter word in 6 tries! This is a faithful recreation of the popular Wordle game with:

• Daily Challenge: Same word for everyone each day
• Color-Coded Feedback: Green for correct position, yellow for wrong position, gray for not in word
• Statistics Tracking: Track your games played, win percentage, and streaks
• Guess Distribution: Visual graph showing your solve patterns
• Beautiful UI: Dark theme with smooth animations

🎮 How to Play

1. Guess the Word: Type a 5-letter word using the on-screen keyboard or your physical keyboard 2. Read the Feedback: - 🟩 Green: Letter is in the correct spot - 🟨 Yellow: Letter is in the word but wrong spot - ⬛ Gray: Letter is not in the word 3. Use Strategy: Use the feedback to narrow down possibilities 4. Win or Lose: Solve it in 6 tries or see the answer

🛠️ Technical Details

Tech Stack

• Backend: Flask (Python)
• Database: SQLite (for statistics)
• Frontend: Vanilla JavaScript, CSS3
• Styling: Custom CSS with animations

API Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | / | GET | Main game page | | /api/new-game | POST | Start a new game | | /api/guess | POST | Submit a guess | | /api/statistics | GET | Get player statistics | | /api/validate/ | GET | Check if word is valid |

File Structure

wordle-clone/
├── manifest.yaml       # App configuration
├── app.py             # Flask backend with game logic
├── wordle.db          # SQLite database (auto-created)
├── README.md          # This file
├── templates/
│   └── index.html     # Main game template
└── static/
    ├── css/
    │   └── style.css  # All styling
    └── js/
        └── game.js    # Game logic and interactions

🚀 Running the App

Manual Start

cd /root/ily.dog/apps/wordle-clone
/root/ily.dog/venv/bin/python app.py

The app runs on port 5040.

Auto-Start

The app is configured with auto_start: true in the manifest, so it will automatically start with the App Hub platform.

🎨 Features

Animations

• Pop Animation: When typing letters
• Flip Animation: When revealing tile colors
• Shake Animation: When submitting invalid words
• Bounce Animation: When winning the game

Accessibility

• Full keyboard support (type letters, Enter to submit, Backspace to delete)
• Visual feedback for all interactions
• Responsive design for mobile and desktop

Statistics

• Games played
• Win percentage
• Current streak
• Maximum streak
• Guess distribution histogram

📝 Word List

The game uses a curated list of ~500 common 5-letter English words, including:

• Common nouns and verbs
• No proper nouns or obscure words
• All words verified to be valid English

🔧 Configuration

The app stores data in:

• SQLite Database: wordle.db (game history, statistics)
• Session Cookies: For identifying returning players

🎯 Tips for Playing

1. Start with vowels: Try words like "audio" or "adieu" to find vowels early 2. Use common letters: R, S, T, L, N, E are most frequent 3. Avoid repeated letters in early guesses 4. Pay attention to position: Yellow letters need to move!

📜 License

Part of the ily.dog App Hub platform.

---

Created by Hermes App Developer Agent on March 15, 2026.