v0.2.4 - Add wordlist filters

Add word list filtering and update to v0.2.4

Introduced a "Filter Wordlist" feature to remove unwanted words using a blocklist (`assets/filter.txt`). Added a sidebar button and dialog to display filtering results. Enhanced word list management with new filtering logic in `generator.py` and UI updates in `ui.py`.

Updated documentation (`README.md`, `CLAUDE.md`, `requirements.md`, `specs.md`) to reflect the new version and features. Modified word lists to include placeholders and additional content. Added `filter.txt` for blocklist management.

Refactored `generator.py` to include `filter_word_file` and improved `sort_word_file`. Updated CSS styles for the new button. Incremented version to `0.2.4` and updated changelog. Ensured compatibility with `/tests` folder structure.

CLAUDE.md

@@ -8,11 +8,11 @@ Wrdler is a simplified vocabulary puzzle game based on BattleWords:
 - **2 free letter guesses at game start** (all instances revealed)
 - **Word composition:** 2 four-letter, 2 five-letter, 2 six-letter words per puzzle
 
-**Current Version:** 0.2.1
+**Current Version:** 0.2.4
 **Repository:** https://github.com/Oncorporation/Wrdler.git
 **Branch:** AI (working branch)
 
-## Current Features (v0.2.1)
+## Current Features (v0.2.4)
 
 ### Core Gameplay
 - 8x6 grid with 6 hidden words (one per row, horizontal only)
@@ -34,6 +34,11 @@ Wrdler is a simplified vocabulary puzzle game based on BattleWords:
 - **Good:** 35-38 points
 - **Keep practicing:** < 35 points
 
+### Word List Management
+- Sidebar controls for sorting and filtering word lists
+- Filter capability using `assets/filter.txt` blocklist to remove unwanted words
+- Dialog display of removed words after filtering
+
 ### Challenge Mode & Remote Storage
 - Short URL-based challenge sharing via `?game_id=<sid>`
 - Each player gets different random words from same wordlist

README.md

@@ -25,7 +25,7 @@ thumbnail: >-
 
 Wrdler is a vocabulary learning game with a simplified grid and strategic letter guessing. The objective is to discover hidden words on a grid by making smart guesses before all letters are revealed.
 
-**Current Version:** v0.2.1
+**Current Version:** v0.2.4
 
 ## Key Differences from BattleWords
 
@@ -69,7 +69,7 @@ Wrdler is a vocabulary learning game with a simplified grid and strategic letter
 
 ### Customization
 - Multiple word lists (classic, fourth_grade, wordlist)
-- Wordlist sidebar controls (picker + one-click sort)
+- Wordlist sidebar controls (picker + one-click sort + filter)
 - Audio volume controls (music and effects separate)
 
 ### ✅ Challenge Mode
@@ -241,7 +241,13 @@ All test files must be placed in the `/tests` folder. This ensures a clean proje
 
 ## Changelog
 
-### v0.2.1 (Current) ✅
+### v0.2.4 (Current) ✅
+**Word List Filtering**
+- ✅ Added "Filter Wordlist" button to sidebar
+- ✅ Filters words against `assets/filter.txt` blocklist
+- ✅ Displays dialog with count and list of removed words
+
+### v0.2.1
 **Daily and Weekly Leaderboards Improved**
 - ✅ Settings-based leaderboard separation (unique leaderboards per settings combo)
 - ✅ Folder-based discovery system (no index.json)

specs/requirements.md

@@ -1,5 +1,5 @@
 # Wrdler: Implementation Requirements
-**Version:** 0.2.1
+**Version:** 0.2.4
 **Status:** Production Ready - Leaderboards Implemented
 **Last Updated:** 2025-12-08
 
@@ -47,6 +47,7 @@ This document breaks down the implementation tasks for Wrdler using the game rul
   - `st.form` + `st.text_input` + `st.form_submit_button("OK")` for word guessing
   - `st.button("New Game")` to reset state
   - Sidebar `selectbox` for wordlist selection (classic, fourth_grade, wordlist)
+  - Sidebar buttons for "Sort Wordlist" and "Filter Wordlist"
 
 - Visualization ✅
   - Ocean-themed gradient background
@@ -95,10 +96,14 @@ This document breaks down the implementation tasks for Wrdler using the game rul
 
 **Acceptance:** ✅ Types implemented and fully integrated (13/13 tests passing)
 
-### 2) Word List Management ✅ (Sprint 1, Enhanced in v0.1.0-0.1.1)
+### 2) Word List Management ✅ (Sprint 1, Enhanced in v0.1.0-0.1.1, v0.2.4)
 - ✅ English word list filtered to alphabetic uppercase, lengths in {4,5,6}
 - ✅ Loader centralized in `word_loader.py` with caching
 - ✅ Three word lists: classic, fourth_grade, wordlist
+- ✅ **Filter functionality** (v0.2.4):
+  - Filter word lists against blocklist (`assets/filter.txt`)
+  - Return count and list of removed words
+  - Display results in UI dialog
 - ✅ **AI word generation** support via `word_loader_ai.py`:
   - Generates 75 words per topic (25 each of lengths 4, 5, 6)
   - **Dual generation modes** (v0.1.0+):

specs/specs.md

@@ -1,5 +1,5 @@
 # Wrdler Game Specifications (specs.md)
-**Version:** 0.2.1
+**Version:** 0.2.4
 **Status:** Production Ready - Leaderboards Implemented
 **Last Updated:** 2025-12-08
 
@@ -61,7 +61,12 @@ Wrdler is a Python/Streamlit vocabulary puzzle game based on BattleWords, but wi
 - ✅ 10 incorrect guess limit per game
 - ✅ Two game modes: Classic (chain guesses) and Too Easy (single guess per reveal)
 
-## Implemented Features (v0.2.1)
+## Implemented Features (v0.2.4)
+
+### Word List Management (v0.2.4)
+- ✅ **Filter Wordlist:** Remove words found in `assets/filter.txt` from the selected word list
+- ✅ **Sort Wordlist:** Sort words by length and alphabetically
+- ✅ **Feedback:** Dialog showing count and list of removed words
 
 ### AI Word Generation (v0.1.0+)
 - ✅ **Topic-Based Generation:** Create custom word lists for any theme using AI
@@ -268,9 +273,14 @@ HF_REPO_ID/
 
 ## Development Status
 
-**Current Version:** 0.2.1 (Production Ready - Leaderboards Implemented)
+**Current Version:** 0.2.4 (Production Ready - Leaderboards Implemented)
 
 ### Completed ✅
+- **v0.2.4:** Word List Filtering
+  - Added "Filter Wordlist" button to sidebar
+  - Implemented blocklist filtering via `assets/filter.txt`
+  - Added results dialog showing removed words
+
 - **v0.2.1:** Daily and Weekly Leaderboards
   - Settings-based leaderboard separation
   - Folder-based discovery (no index.json)

wrdler/__init__.py

@@ -9,5 +9,5 @@ Key differences from BattleWords:
 - Daily and weekly leaderboards
 """
 
-__version__ = "0.2.3"
+__version__ = "0.2.4"
 __all__ = ["models", "generator", "logic", "ui", "word_loader", "leaderboard", "leaderboard_page"]

wrdler/assets/filter.txt

@@ -0,0 +1,275 @@
+END
+RAN
+SAW
+WIN
+BUYS
+CALV
+DANS
+ELMY
+ENDS
+FLTE
+FRYD
+GETS
+HARV
+MANU
+NUNC
+OARE
+OPEX
+PAYS
+PUTS
+RADE
+RECT
+ROPS
+RUNS
+SAID
+SAYS
+SEES
+SENT
+SERV
+SIMP
+SITS
+SKIL
+STAM
+SWAM
+TOLD
+TURK
+USED
+USES
+WINS
+ADJAR
+ASKED
+BALLS
+BLTIG
+BOATS
+BOILD
+BOOKS
+BURNS
+BUTTI
+CALLS
+CUEPS
+DEPTS
+DRIED
+FEELS
+FINDS
+FIXED
+FLOWE
+FOMIT
+FOULE
+FRAPS
+FRAZE
+FROWS
+GAMEY
+GIVES
+HARVE
+HELPS
+JABBY
+JOTTY
+JUMPS
+KEEPS
+KICKS
+KITCH
+LIKED
+LISTO
+LOOKS
+LOREY
+LOVED
+LURKY
+MAKES
+MANTO
+MARIN
+MASTO
+MEETS
+MOVES
+OPENS
+PLAYS
+PLOOM
+PREPS
+PUNGY
+PURTY
+READS
+REELD
+REPLA
+REPOS
+RESTS
+RINGS
+ROBSO
+RODER
+RODIN
+ROODY
+ROSEY
+ROUPS
+ROWLS
+RUBED
+RUPES
+RUPTS
+RUYSY
+SAVAN
+SELLS
+SENDS
+SHOWS
+SHRIL
+SINGS
+SKIPS
+SMAKE
+STIRD
+STIRP
+STOPS
+TAKES
+TAXIS
+TELLS
+TEMPP
+TRIED
+TRIES
+TRIMM
+TURNS
+VEGET
+WAITS
+WALKS
+WANTS
+WORKS
+BAROBA
+BAUGHT
+BRAINS
+BREADS
+BROWNS
+BROWNY
+BURSTS
+CALLED
+CHAIRS
+CLOSED
+CLOUDS
+COLORS
+COOKED
+COOKIN
+DANCED
+DANCES
+DREAMS
+DRINKS
+DRIVED
+DRIVES
+EAGLES
+EARTHS
+ELBOWS
+FANATE
+FANOUT
+FLOURD
+GRILLD
+HELPED
+JUMPED
+KNEADD
+KNITWE
+KNOWED
+LEAVES
+LOOKED
+OPENED
+PLAYED
+PULLED
+PUSHED
+REYLES
+ROLLED
+SHOWED
+SINGED
+STANDS
+STARTS
+STUNED
+TAUGHT
+THINKS
+TOUCHS
+TURNED
+WAITED
+WALKED
+WANTED
+WORKED
+WRITES
+ZIPPER
+BUNCHES
+CANDIES
+CARROTS
+CHALKES
+CIRCLES
+CLEANED
+COOKIES
+CORNERS
+COTTONS
+COUSINS
+CRASHED
+CRAYONS
+DANGERS
+DESERTS
+DINNERS
+DOCTORS
+DOLLARS
+DRAGONS
+DRAWERS
+DRESSED
+DRILLED
+DRINKED
+ENGINES
+FARMERS
+FINGERS
+FORESTS
+FRIENDS
+GARDENS
+GLIDERS
+HAMMERS
+HAPPENS
+HOCKEYS
+INSECTS
+ISLANDS
+JACKETS
+JUNGLES
+KITTENS
+LADDERS
+LAUGHED
+LETTERS
+LIZARDS
+MARKETS
+MIRRORS
+MONKEYS
+MOTHERS
+MUFFINS
+NUMBERS
+ORANGES
+PENCILS
+PEPPERS
+PERSONS
+PICNICS
+PILLOWS
+PIRATES
+PLANETS
+POCKETS
+PUZZLES
+RABBITS
+RECORDS
+ROCKETS
+SADDLES
+SEASONS
+SHADOWS
+SILVERS
+SISTERS
+SKATERS
+SOCCERS
+SPIDERS
+SPRINGS
+SQUARES
+STARTED
+STOPPED
+STRINGS
+STUDIED
+SUMMERS
+SUNSETS
+TICKETS
+TISSUES
+TURTLES
+VALLEYS
+WATCHED
+WATCHES
+WINDOWS
+WINTERS
+CHERRIES
+CHICKENS
+FAMILIES
+LISTENED
+POTATOES
+STITCHES
+STOMACHS

wrdler/generator.py

@@ -295,4 +295,49 @@ def sort_word_file(filepath: str) -> List[str]:
     words = [line.strip() for line in lines if line.strip() and not line.strip().startswith("#")]
     # Sort by length, then alphabetically
     sorted_words = sorted(words, key=lambda w: (len(w), w))
-    return sorted_words
+    return sorted_words
+
+
+def filter_word_file(filter_filepath: str, target_filepath: str) -> tuple[int, List[str]]:
+    """
+    Removes words found in filter_filepath from target_filepath.
+    Overwrites target_filepath with the filtered content.
+    Returns (number of words removed, list of removed words).
+    """
+    # Read filter words
+    try:
+        with open(filter_filepath, "r", encoding="utf-8") as f:
+            filter_words = {
+                line.strip().upper() 
+                for line in f 
+                if line.strip() and not line.strip().startswith("#")
+            }
+    except FileNotFoundError:
+        return 0, []
+
+    # Read target file lines
+    with open(target_filepath, "r", encoding="utf-8") as f:
+        lines = f.readlines()
+
+    new_lines = []
+    removed_words = []
+
+    for line in lines:
+        stripped = line.strip()
+        # Preserve comments and empty lines
+        if not stripped or stripped.startswith("#"):
+            new_lines.append(line)
+            continue
+        
+        # Check if word is in filter list
+        if stripped.upper() in filter_words:
+            removed_words.append(stripped)
+        else:
+            new_lines.append(line)
+
+    # Write back if changes were made
+    if removed_words:
+        with open(target_filepath, "w", encoding="utf-8") as f:
+            f.writelines(new_lines)
+
+    return len(removed_words), removed_words

wrdler/ui.py

@@ -14,7 +14,7 @@ import numpy as np
 import time
 from datetime import datetime
 
-from .generator import generate_puzzle, sort_word_file
+from .generator import generate_puzzle, sort_word_file, filter_word_file
 from .logic import build_letter_map, reveal_cell, reveal_free_letter, guess_word, is_game_over, compute_tier, auto_mark_completed_words, hidden_word_display
 from .models import Coord, GameState, Puzzle
 from .word_loader import get_wordlist_files, load_word_list, load_word_list_or_ai, compute_word_difficulties, get_wordlist_info
@@ -527,8 +527,8 @@ border-radius: 50% !important;
             text-align: center;
           }
           div[data-testid="stButton"] button { max-width: 100%; aspect-ratio: 16 / 11; border-radius: 0; background: #1d64c8; color: #ffffff; font-weight: 700; padding: 0.5rem 0.75rem; min-height: 2.5rem; min-width: 1.75rem;}
-          .st-key-new_game_btn, .st-key-sort_wordlist_btn { margin: 0 auto; aspect-ratio: unset; z-index:9999;}
-          .st-key-new_game_btn > div[data-testid="stButton"] button, .st-key-sort_wordlist_btn > div[data-testid="stButton"] button { aspect-ratio: unset; text-align:center; height: auto;}
+          .st-key-new_game_btn, .st-key-sort_wordlist_btn, .st-key-filter_wordlist_btn { margin: 0 auto; aspect-ratio: unset; z-index:9999;}
+          .st-key-new_game_btn > div[data-testid="stButton"] button, .st-key-sort_wordlist_btn > div[data-testid="stButton"] button, .st-key-filter_wordlist_btn > div[data-testid="stButton"] button { aspect-ratio: unset; text-align:center; height: auto;}
 
           div[data-testid="column"], .st-emotion-cache-zh2fnc { width: auto !important; flex: 1 1 auto !important; min-width: 100% !important; max-width: 100% !important; }
           .st-emotion-cache-1permvm, .st-emotion-cache-1n6tfoc { gap:0.25rem !important; min-height: 2.5rem; min-width: 2.5rem;}          
@@ -545,7 +545,7 @@ border-radius: 50% !important;
             position:relative;
             z-index: 1200;
             }
-          .username_input id[="text_input"], .st-key-username_input id[="text_input"] { color: #fff;}
+          .username_input [id^="text_input"], .st-key-username_input [id^="text_input"] { color: #fff;}
           .st-emotion-cache-18kf3ut, .stColumn.st-emotion-cache-116javk {padding-bottom:3px;}
 
           /* grid adjustments */
@@ -557,7 +557,7 @@ border-radius: 50% !important;
           # }
           @media (min-width: 560px){
            div[data-testid="stButton"] button { max-width: 100%; aspect-ratio: 16 / 11; min-height: 1.75rem; display: flex;}           
-           .st-key-new_game_btn > div[data-testid="stButton"] button, .st-key-sort_wordlist_btn > div[data-testid="stButton"] button { min-height: calc(100% + 20px) !important;}
+           .st-key-new_game_btn > div[data-testid="stButton"] button, .st-key-sort_wordlist_btn > div[data-testid="stButton"] button, .st-key-filter_wordlist_btn > div[data-testid="stButton"] button { min-height: calc(100% + 20px) !important;}
            .st-emotion-cache-ckafi0 { gap:0.1rem !important; min-height: calc(100% + 20px) !important; aspect-ratio: 16 / 11; width: auto !important;  flex: 1 1 auto !important;  min-width: 100% !important;  max-width: 100% !important;}
            /*.st-emotion-cache-1n6tfoc { aspect-ratio: 16 / 11; min-height: calc(100% + 20px) !important;}*/
            .st-emotion-cache-1n6tfoc::before { min-height: calc(100% + 20px) !important; }
@@ -788,7 +788,7 @@ def _new_game() -> None:
     if st.session_state.get("enable_free_letters", False):
         st.session_state.last_action = "Welcome to Wrdler! Choose 2 free letters to start."
     else:
-        st.session_state.last_action = "Welcome to Wrdler! Reveal cells and guess words on each line!"
+        st.session_state.last_action = "Welcome to Wrdler! Reveal cells and guess the words on each line!"
     st.session_state.can_guess = False
     st.session_state.points_by_word = {}
     st.session_state.letter_map = build_letter_map(puzzle)
@@ -1111,6 +1111,8 @@ def _render_sidebar():
             if not st.session_state.use_ai_wordlist:
                 if st.button("Sort Wordlist", width=125, key="sort_wordlist_btn"):
                     _sort_wordlist(st.session_state.selected_wordlist)
+                if st.button("Filter Wordlist", width=125, key="filter_wordlist_btn"):
+                    _filter_wordlist(st.session_state.selected_wordlist)
         else:
             st.info("No word lists found in words/ directory. Using AI or built-in fallback.")
             # Force AI mode if no files available
@@ -1508,6 +1510,21 @@ def _sort_wordlist(filename):
     time.sleep(5)  # 5 second delay before starting new game
     _new_game()
 
+def _filter_wordlist(filename):
+    filter_path = os.path.join(os.path.dirname(__file__), "assets", "filter.txt")
+    words_path = os.path.join(os.path.dirname(__file__), "words", filename)
+    
+    if not os.path.exists(filter_path):
+        st.error("Filter file not found (wrdler/assets/filter.txt).")
+        return
+
+    count, removed_words = filter_word_file(filter_path, words_path)
+    
+    if count > 0:
+        _filter_results_dialog(count, removed_words, filename)
+    else:
+        st.info(f"No words removed from {filename}.")
+
 def _render_hit_miss(state: GameState):
     # Determine last reveal outcome from last_action string
     action = (state.last_action or "").strip()
@@ -2233,7 +2250,7 @@ def _game_over_content(state: GameState) -> None:
             else:
                 # Do not display the share URL, but confirm it's saved/submitted
                 st.success("✅ Your result has been saved.")
-        
+
         # Show leaderboard submission status if already submitted
         if st.session_state.get("leaderboard_submitted", False):
             lb_results = st.session_state.get("leaderboard_results", {})
@@ -2285,12 +2302,24 @@ def _game_over_content(state: GameState) -> None:
         st.rerun()
 
 
+def _filter_results_content(count: int, words: list[str], filename: str):
+    st.success(f"Removed {count} words from {filename}")
+    st.markdown("### Removed Words")
+    st.text_area("List", value="\n".join(words), height=200, disabled=True)
+    if st.button("Close", key="close_filter_dialog"):
+        st.rerun()
+
+
 # Prefer st.dialog/experimental_dialog; fallback to st.modal if unavailable
 _Dialog = getattr(st, "dialog", getattr(st, "experimental_dialog", None))
 if _Dialog:
     @_Dialog("Game Over")
     def _game_over_dialog(state: GameState):
         _game_over_content(state)
+
+    @_Dialog("Filter Results")
+    def _filter_results_dialog(count, words, filename):
+        _filter_results_content(count, words, filename)
 else:
     def _game_over_dialog(state: GameState):
         modal_ctx = getattr(st, "modal", None)
@@ -2302,6 +2331,15 @@ else:
             st.subheader("Game Over")
             _game_over_content(state)
 
+    def _filter_results_dialog(count, words, filename):
+        modal_ctx = getattr(st, "modal", None)
+        if callable(modal_ctx):
+            with modal_ctx("Filter Results"):
+                _filter_results_content(count, words, filename)
+        else:
+            st.info(f"Removed {count} words from {filename}")
+            st.text_area("Removed Words", value="\n".join(words), height=200)
+
 def _render_game_over(state: GameState):
     # Use hide_gameover_overlay (same key as run_app) with inverted logic
     visible = not st.session_state.get("hide_gameover_overlay", False) and is_game_over(state)

wrdler/words/cooking.txt

@@ -1,16 +1,11 @@
-# AI-generated word list
-# Topic: COOKing
-# Last updated: 2025-11-28 12:16:45
-# Total words: 174
-# Format: one word per line, sorted by length then alphabetically
-#
+# Optional: place a large A–Z word list here (one word per line).
+# The app falls back to built-in pools if fewer than 500 words per length are found.
 BAKE
 BEEN
 BLUE
 BOIL
 BUFF
 CAKE
-CALV
 CARD
 COOK
 FARM
@@ -20,15 +15,12 @@ FIRE
 FISH
 FIZZ
 FOOD
-FRYD
-HARV
 HERB
 JUST
 KEEN
 KERN
 KING
 MAKE
-MANU
 MASH
 MEAT
 MINI
@@ -39,13 +31,10 @@ POUR
 PREP
 PUFF
 RACK
-RECT
 ROLL
 SEAR
 SEEK
 SIFT
-SIMP
-SKIL
 SKIP
 SLOW
 SOFT
@@ -54,7 +43,6 @@ STEW
 STIR
 TAKE
 THAW
-TURK
 VEAL
 WARM
 WASH
@@ -66,12 +54,8 @@ BAKED
 BASTE
 BLANK
 BLEND
-BLTIG
-BOATS
-BOILD
 BREAD
 BROWN
-BUTTI
 CANDY
 CARBS
 CHICK
@@ -79,7 +63,6 @@ CHILL
 CLEAN
 CRUMB
 CRUST
-DRIED
 FLAKY
 FRIED
 FRUIT
@@ -88,50 +71,38 @@ GLAZE
 GRAIN
 GRASS
 GRILL
-HARVE
 HERBS
 HOUSE
-KITCH
 KNEAD
-MARIN
 MIXED
 MIXER
 PASTA
 PLATE
-PREPS
 PUREE
 QUICK
 ROAST
-RUBED
 SALAD
 SALTY
 SAUTE
 SCONE
 SHAVE
-SHRIL
 SLICE
 SLICK
-SMAKE
 SPICE
 SPICY
 SPIRE
 START
 STEAK
 STICK
-STIRD
-STIRP
 STOVE
 SWEET
 TASTE
 TASTY
-TEMPP
 THINK
 TOAST
 TREAT
-TRIMM
 TWIST
 UNDER
-VEGET
 WHISK
 WIELD
 YIELD
@@ -139,27 +110,19 @@ ZESTY
 ASSERT
 BARELY
 BARKED
-BAROBA
 BATTER
-BAUGHT
 BAZAAR
 BITTER
 BOILED
-BROWNY
 CARROT
 CHEESE
-COOKED
 COOKER
-COOKIN
 DETAIL
 DILUTE
 EATING
-FLOURD
 FLYING
 FROZEN
 GRATED
-GRILLD
-KNEADD
 LITTLE
 MARINA
 MASHED
@@ -176,5 +139,4 @@ SMOOTH
 SNAKES
 SPICED
 TASTES
-TOUCHS
 VEGGIE

wrdler/words/english.txt

@@ -1,9 +1,5 @@
-# AI-generated word list
-# Topic: English
-# Last updated: 2025-12-04 10:32:04
-# Total words: 601
-# Format: one word per line, sorted by length then alphabetically
-#
+# Optional: place a large A–Z word list here (one word per line).
+# The app falls back to built-in pools if fewer than 500 words per length are found.
 ALES
 ALMS
 ARMY

wrdler/words/fourth_grade.txt

@@ -1,3 +1,5 @@
+# Optional: place a large A–Z word list here (one word per line).
+# The app falls back to built-in pools if fewer than 500 words per length are found.
 area
 ball
 band
@@ -94,6 +96,9 @@ stay
 step
 stop
 tail
+taxi
+taxi
+taxi
 team
 tent
 test
@@ -118,6 +123,8 @@ board
 brain
 bread
 brush
+bunny
+bunny
 candy
 chair
 chalk
@@ -130,23 +137,44 @@ clean
 clock
 cloud
 color
+color
+color
+comic
+comic
 count
 cover
 crash
 cross
 dance
+dream
+dream
+dress
 dress
+dress
+drink
 drink
+drink
+drive
 drive
+drive
+eagle
 eagle
+eagle
+early
+early
+earth
 earth
+earth
+elbow
 elbow
+elbow
+empty
+empty
 empty
 fence
 field
 flash
 floor
-flower
 frame
 fruit
 glass
@@ -180,7 +208,6 @@ queen
 radio
 river
 salty
-school
 shape
 shark
 sheep
@@ -221,374 +248,347 @@ white
 witch
 world
 write
-yellow
-animal
-answer
-autumn
-bamboo
-banana
-basket
-battle
-beaver
-bellow
-bottle
-bridge
-bubble
-butter
-button
-cactus
-camera
-candle
-canyon
-carrot
-castle
-circle
-circus
-cotton
-cousin
-crayon
-desert
-dinner
-doctor
-dollar
-dragon
-drawer
-engine
-family
-farmer
-finger
-forest
-friend
-garden
-glider
-hammer
-happen
-hockey
-insect
-island
-jacket
-jungle
-kitten
-ladder
-letter
-lizard
-market
-mirror
-monkey
-mother
-muffin
-number
-orange
-pencil
-pepper
-person
-picnic
-pillow
-pirate
-planet
-pocket
-potato
-puzzle
-rabbit
-record
-rocket
-saddle
-season
-shadow
-silver
-sister
-skater
-soccer
-spider
-spring
-square
-stitch
-stomach
-string
-summer
-sunset
-taxi
-ticket
-tissue
-turtle
-valley
-window
-winter
-zipper
 accept
+accept
+across
 across
 action
+action
+active
 active
 anchor
+anchor
+animal
+answer
+arrive
 arrive
 artist
+artist
+asleep
 asleep
 attack
+attack
+autumn
+awaken
 awaken
 baking
-balloon
+baking
+bamboo
+banana
+barrel
 barrel
+basket
+battle
 beauty
+beauty
+beaver
 behave
+behave
+behind
 behind
 belief
+belief
+bellow
 belong
+belong
+better
 better
 bitter
-blanket
+bitter
+border
 border
+bottle
+bottom
 bottom
 breeze
+breeze
+bridge
 bright
+bright
+broken
 broken
+bubble
 bucket
-bunny
+bucket
+burrow
 burrow
+butter
+button
 button
+button
+cactus
 cactus
+cactus
+camera
 camera
 candle
+candle
+candle
+canyon
+canyon
 canyon
 carrot
+carrot
+carrot
+castle
+castle
 castle
 cement
+cement
+center
 center
 chance
+chance
+change
 change
 charge
+charge
+cheese
 cheese
 cherry
-chicken
+cherry
+circle
 circle
+circle
+circus
 circus
+circus
+closer
 closer
 cloudy
+cloudy
+coffee
 coffee
 collar
-color
+collar
+comedy
 comedy
-comic
 common
+common
+corner
 corner
 cotton
+cotton
+cotton
 cousin
+cousin
+cousin
+crayon
+crayon
 crayon
 create
+create
+danger
 danger
 decide
+decide
+degree
 degree
 desert
+desert
+desert
+dinner
+dinner
 dinner
 doctor
+doctor
+doctor
+dollar
 dollar
+dollar
+dragon
+dragon
 dragon
 drawer
-dream
-dress
-drink
-drive
-eagle
-early
-earth
-elbow
-empty
+drawer
+drawer
+engine
 engine
+engine
+family
 family
+family
+farmer
 farmer
+farmer
+finger
 finger
+finger
+flower
 forest
+forest
+forest
+friend
+friend
 friend
 garden
+garden
+garden
+glider
 glider
+glider
+hammer
 hammer
+hammer
+happen
 happen
+happen
+hockey
 hockey
+hockey
+insect
 insect
+insect
+island
 island
+island
+jacket
 jacket
+jacket
+jungle
 jungle
+jungle
+kitten
 kitten
+kitten
+ladder
 ladder
+ladder
+letter
 letter
+letter
+lizard
 lizard
+lizard
+market
 market
+market
+mirror
 mirror
+mirror
+monkey
 monkey
+monkey
+mother
+mother
 mother
 muffin
+muffin
+muffin
+number
+number
 number
 orange
+orange
+orange
+pencil
+pencil
 pencil
 pepper
+pepper
+pepper
+person
+person
 person
 picnic
+picnic
+picnic
+pillow
+pillow
 pillow
 pirate
+pirate
+pirate
+planet
+planet
 planet
 pocket
+pocket
+pocket
+potato
+potato
 potato
 puzzle
+puzzle
+puzzle
+rabbit
+rabbit
 rabbit
 record
+record
+record
+rocket
 rocket
+rocket
+saddle
 saddle
+saddle
+school
 season
+season
+season
+shadow
+shadow
 shadow
 silver
+silver
+silver
+sister
+sister
 sister
 skater
+skater
+skater
+soccer
+soccer
 soccer
 spider
+spider
+spider
+spring
+spring
 spring
 square
+square
+square
 stitch
-stomach
+stitch
+stitch
+string
 string
+string
+summer
+summer
 summer
 sunset
-taxi
+sunset
+sunset
+ticket
 ticket
+ticket
+tissue
 tissue
+tissue
+turtle
 turtle
+turtle
+valley
 valley
+valley
+window
 window
+window
+winter
 winter
+winter
+yellow
 zipper
-accept
-across
-action
-active
-anchor
-arrive
-artist
-asleep
-attack
-awaken
-baking
 balloon
-barrel
-beauty
-behave
-behind
-belief
-belong
-better
-bitter
+balloon
+blanket
 blanket
-border
-bottom
-breeze
-bright
-broken
-bucket
-bunny
-burrow
-button
-cactus
-candle
-canyon
-carrot
-castle
-cement
-center
-chance
-change
-charge
-cheese
-cherry
 chicken
-circle
-circus
-closer
-cloudy
-coffee
-collar
-color
-comedy
-comic
-common
-corner
-cotton
-cousin
-crayon
-create
-danger
-decide
-degree
-desert
-dinner
-doctor
-dollar
-dragon
-drawer
-dream
-dress
-drink
-drive
-eagle
-early
-earth
-elbow
-empty
-engine
-family
-farmer
-finger
-forest
-friend
-garden
-glider
-hammer
-happen
-hockey
-insect
-island
-jacket
-jungle
-kitten
-ladder
-letter
-lizard
-market
-mirror
-monkey
-mother
-muffin
-number
-orange
-pencil
-pepper
-person
-picnic
-pillow
-pirate
-planet
-pocket
-potato
-puzzle
-rabbit
-record
-rocket
-saddle
-season
-shadow
-silver
-sister
-skater
-soccer
-spider
-spring
-square
-stitch
+chicken
+stomach
+stomach
 stomach
-string
-summer
-sunset
-taxi
-ticket
-tissue
-turtle
-valley
-window
-winter
-zipper

wrdler/words/sports.txt

@@ -1,12 +1,9 @@
-# AI-generated word list
-# Topic: sporTS
-# Last updated: 2025-12-04 10:41:42
-# Total words: 164
-# Format: one word per line, sorted by length then alphabetically
-#
+# Optional: place a large A–Z word list here (one word per line).
+# The app falls back to built-in pools if fewer than 500 words per length are found.
 ARMS
 BALL
 BASK
+BOWL
 BOWS
 BULL
 DART
@@ -21,6 +18,7 @@ GAIN
 GALE
 GENT
 GILD
+GUNS
 HALE
 HARE
 HINT
@@ -29,6 +27,7 @@ HOOP
 HOPS
 HUES
 JAWS
+JINX
 JUMP
 KICK
 LANE
@@ -47,15 +46,14 @@ SHIP
 SHOE
 SOAR
 SOFA
+SOLO
 SPAN
 SWIM
 TALK
 WING
 BAILS
-BALLS
 BENCH
 BENDS
-BOWL
 CHAMP
 CLUBS
 CURLS
@@ -71,8 +69,8 @@ FLARE
 FLAWS
 FLICK
 FLINT
-FLUTE
 FLUKE
+FLUTE
 GAINS
 GAMER
 GAMES
@@ -82,14 +80,12 @@ GOLFS
 GOUTS
 GRAFT
 GROAN
-GUNS
 HAILS
 HEATS
 HEELS
 HOOPS
 HORNS
 HORSE
-JINX
 JOLTS
 KNITS
 LANCE
@@ -120,7 +116,6 @@ SLIDE
 SLIPS
 SLOPE
 SOLES
-SOLO
 SPITE
 SPOKE
 SPOON
@@ -137,7 +132,6 @@ TABLE
 TEAMS
 TRACK
 TRAMP
-TURNS
 WREST
 BASKET
 BIKERS
@@ -167,4 +161,4 @@ STITCH
 SURFER
 SURVEY
 TAILOR
-WINNER
+WINNER

wrdler/words/wordlist.txt

@@ -1,9 +1,5 @@
-# AI-generated word list
-# Topic: wordlisT
-# Last updated: 2025-11-28 12:18:24
-# Total words: 581
-# Format: one word per line, sorted by length then alphabetically
-#
+# Optional: place a large A–Z word list here (one word per line).
+# The app falls back to built-in pools if fewer than 500 words per length are found.
 ABLE
 ACID
 AGED
@@ -137,7 +133,6 @@ FISH
 FIVE
 FLAT
 FLOW
-FLTE
 FOAM
 FOOD
 FOOT
@@ -290,7 +285,6 @@ NICK
 NINE
 NOSE
 NOTE
-NUNC
 OBEY
 ODDS
 OILY
@@ -358,7 +352,6 @@ ROSE
 RULE
 RUSH
 SAFE
-SAID
 SAKE
 SALE
 SALT
@@ -374,8 +367,6 @@ SEEN
 SELF
 SELL
 SEND
-SENT
-SERV
 SETT
 SEXY
 SHED
@@ -438,7 +429,6 @@ THIN
 THIS
 TIME
 TINY
-TOLD
 TOLL
 TONE
 TOOL
@@ -453,7 +443,6 @@ TWIN
 TYPE
 UNIT
 UPON
-USED
 USER
 VARY
 VAST
@@ -501,7 +490,6 @@ YELL
 YOGA
 ZERO
 ZONE
-ADJAR
 APPLE
 BLAST
 BOARD