v0.2.9

Bump version to 0.2.9; enhance settings management

Refactored settings management:
- Added `_prepare_settings_for_save` and `save_active_settings` for better handling of `settings.json`.
- Introduced `edit_settings_configuration` for overwriting specific settings files.
- Enhanced `settings_page.py` with support for creating, updating, renaming, and deleting settings files.
- Split "Save Settings" into "Create Settings" and "Update Settings" buttons.
- Improved settings loading logic and user feedback.

Updated default configurations:
- Enabled sound effects by default in `settings.json` and `classic-classic-1.json`.
- Added `classic-classic-full_sound_free_letters.json`.
- Removed deprecated `classic-classic-2.json`.

Other changes:
- Updated footer navigation to prevent reloading active pages.
- Incremented version to `0.2.9` in `CLAUDE.md`, `specs.md`, and `__init__.py`.
- Improved maintainability and usability across the codebase.

CLAUDE.md

@@ -1,6 +1,6 @@
 # CLAUDE
 
-Wrdler v0.2.8
+Wrdler v0.2.9
 
 # Wrdler - Project Context
 
@@ -12,11 +12,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.8
+**Current Version:** 0.2.9
 **Repository:** https://github.com/Oncorporation/Wrdler.git
 **Branch:** AI (working branch)
 
-## Current Features (v0.2.7)
+## Current Features (v0.2.9)
 
 ### Core Gameplay
 - 8x6 grid with 6 hidden words (one per row, horizontal only)
@@ -38,11 +38,17 @@ Wrdler is a simplified vocabulary puzzle game based on BattleWords:
 - **Good:** 35-38 points
 - **Keep practicing:** < 35 points
 
-### Settings Page
+### Settings Page & Management
 - All game settings moved from sidebar to a dedicated Settings page (`?page=settings`)
 - Accessible via footer navigation (`⚙️ Settings` link)
 - Local JSON-based settings persistence in `wrdler/settings/`
 - Latest settings auto-loaded on startup
+- Enhanced settings management: create, update, rename, and delete settings files
+- Split "Save Settings" into "Create Settings" and "Update Settings" actions
+- Improved settings loading and user feedback
+- Default sound effects enabled in settings
+- New default configuration: `classic-classic-full_sound_free_letters.json`
+- Deprecated configuration removed: `classic-classic-2.json`
 - Sidebar now focused on lightweight controls (if any) and navigation
 
 ### Word List Management
@@ -89,17 +95,20 @@ Wrdler is a simplified vocabulary puzzle game based on BattleWords:
 ### Audio & Visuals
 - Ocean-themed gradient background with wave animations
 - Toggleable background music with volume control (configured via Settings page, played globally)
-- Sound effects (hit/miss/correct/incorrect) with volume control (configured via Settings page)
+- Sound effects (hit/miss/correct/incorrect) with volume control (configured via Settings page, enabled by default)
 
 ### PWA Support
 - Installable as Progressive Web App on desktop and mobile
 - Service worker for offline caching of static assets
 - Works offline for basic functionality
 
+### Footer Navigation
+- Updated to prevent reloading active pages
+
 ## Technical Architecture
 
 ### Technology Stack
-- **Framework:** Streamlit 1.51.0
+- **Framework:** Streamlit 1.52.1
 - **Language:** Python 3.12.8 (requires >=3.12, <3.13)
 - **Remote Storage:** huggingface_hub (>=0.20.0)
 - **AI Generation:** transformers, gradio_client
@@ -111,24 +120,24 @@ Wrdler is a simplified vocabulary puzzle game based on BattleWords:
 wrdler/
 ├── app.py                    # Streamlit entry point
 ├── wrdler/                   # Main package
-│   ├── __init__.py          # Version: 0.2.7
+│   ├── __init__.py          # Version: 0.2.9
 │   ├── models.py            # Data models (Coord, Word, Puzzle, GameState)
 │   ├── generator.py         # Puzzle generation with deterministic seeding
 │   ├── logic.py             # Game mechanics (reveal, guess, scoring)
 │   ├── ui.py                # Streamlit UI with query param routing
-│   ├── oauth.py             # HuggingFace OAuth utilities (NEW)
-│   ├── settings_page.py     # Settings page UI (implemented, query-param route ?page=settings)
+│   ├── oauth.py             # HuggingFace OAuth utilities
+│   ├── settings_page.py     # Settings page UI (enhanced)
 │   ├── leaderboard.py       # Leaderboard system (daily/weekly)
 │   ├── leaderboard_page.py  # Leaderboard UI page
 │   ├── word_loader.py       # Word list management
 │   ├── word_loader_ai.py    # AI word generation
 │   ├── game_storage.py      # HF game storage wrapper
 │   ├── version_info.py      # Version display
-│   ├── modules/             # Shared utility modules (from OpenBadge)
+│   ├── modules/             # Shared utility modules
 │   │   ├── __init__.py      # Module exports
-│   │   ├── storage.py       # HuggingFace storage & URL shortener (with folder listing)
+│   │   ├── storage.py       # HuggingFace storage & URL shortener
 │   │   ├── storage.md       # Storage module documentation
-│   │   ├── constants.py     # Storage-related constants (trimmed)
+│   │   ├── constants.py     # Storage-related constants
 │   │   └── file_utils.py    # File utility functions
 │   └── words/               # Word list files
 │       ├── classic.txt      # Default word list
@@ -137,26 +146,19 @@ wrdler/
 ├── specs/                   # Documentation
 ├── static/                  # PWA assets (manifest.json, service-worker.js)
 ├── .env                     # Environment variables (HF credentials)
-├── pyproject.toml          # Project metadata
-├── requirements.txt        # Dependencies
-├── uv.lock                 # UV lock file
-├── Dockerfile              # Container deployment
-├── README.md               # User-facing documentation
-├── CLAUDE.md               # This file - project context for Claude
-├── GAMEPLAY_GUIDE.md       # User guide with tips and strategies
-├── pyproject.toml          # Project metadata
-├── requirements.txt        # Dependencies
-├── uv.lock                 # UV lock file
-├── Dockerfile              # Container deployment
-├── README.md               # User-facing documentation
-├── CLAUDE.md               # This file - project context for Claude
-├── GAMEPLAY_GUIDE.md       # User guide with tips and strategies
+├── pyproject.toml           # Project metadata
+├── requirements.txt         # Dependencies
+├── uv.lock                  # UV lock file
+├── Dockerfile               # Container deployment
+├── README.md                # User-facing documentation
+├── CLAUDE.md                # This file - project context for Claude
+├── GAMEPLAY_GUIDE.md        # User guide with tips and strategies
 ```
 
 ### Page Navigation System
 Uses **query parameter-based routing** (NOT Streamlit multi-page):
 - `?page=today|daily|weekly|history` → Leaderboard pages
-- `?page=settings` → Settings page (no OAuth gating yet, local settings JSON persistence)
+- `?page=settings` → Settings page
 - `?game_id=<sid>` → Challenge mode
 - No query params → Main game page
 
@@ -212,7 +214,7 @@ HF_REPO_ID=YourUsername/YourRepo       # Dataset repo for challenge storage
 USE_HF_WORDS=false                     # Enable HF Space API for word generation
 HF_WORD_LIST_REPO_ID=YourUsername/WordRepo  # Dataset repo for AI word lists
 
-# OAuth Admin Access (NEW)
+# OAuth Admin Access
 ADMIN_USERS=username1,username2        # Comma-separated list of admin usernames
 MAX_DISPLAY_ENTRIES=25                 # Max leaderboard entries to display (default: 25)
 ```
@@ -279,8 +281,8 @@ Move all game settings from sidebar to a dedicated settings page at `?page=setti
 
 ### Files to Modify
 - `wrdler/ui.py` - Add settings page routing, remove sidebar settings
-- `wrdler/settings_page.py` - NEW FILE - Settings UI with OAuth protection
-- `wrdler/oauth.py` - Already created ✅
+- `wrdler/settings_page.py` - Settings UI with OAuth protection (enhanced)
+- `wrdler/oauth.py` - Already created
 
 ### Key OAuth Functions (wrdler/oauth.py)
 ```python
@@ -310,7 +312,7 @@ if page in {"today", "daily", "weekly", "history"}:
     render_leaderboard_page(default_tab=page)
     return
 
-if page == "settings":  # TO BE IMPLEMENTED
+if page == "settings":
     render_settings_page()
     return
 

README.md

@@ -21,7 +21,7 @@ thumbnail: >-
 
 # Wrdler
 
-Version 0.2.8
+Version 0.2.9
 
 Wrdler is a vocabulary puzzle game with daily and weekly leaderboards, 8x6 grid, and two free letter guesses at the start. See CHANGELOG or specs for details on the latest updates.
 
@@ -29,7 +29,7 @@ Wrdler is a vocabulary puzzle game with daily and weekly leaderboards, 8x6 grid,
 
 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.8
+**Current Version:** v0.2.9
 
 ## Key Differences from BattleWords
 
@@ -54,7 +54,7 @@ Wrdler is a vocabulary learning game with a simplified grid and strategic letter
 ### Audio & Visuals
 - Ocean-themed gradient background with wave animations
 - Background music system (toggleable with volume control)
-- Sound effects for hits, misses, correct/incorrect guesses
+- Sound effects for hits, misses, correct/incorrect guesses (enabled by default)
 - Responsive UI built with Streamlit
 
 ### AI Word Generation
@@ -71,10 +71,16 @@ Wrdler is a vocabulary learning game with a simplified grid and strategic letter
 - **Fallback support**: Gracefully uses dictionary words if AI generation fails
 - **Guaranteed distribution**: Ensures exactly 25 words each of lengths 4, 5, and 6
 
-### Customization
+### Customization & Settings Management
 - Multiple word lists (classic, fourth_grade, wordlist)
 - Dedicated Settings page (`⚙️ Settings` in footer) for wordlist selection, game mode, grid options, and audio
 - Audio volume controls (music and effects separate)
+- Enhanced settings management: create, update, rename, and delete settings files
+- Split "Save Settings" into "Create Settings" and "Update Settings" actions
+- Improved settings loading and user feedback
+- Default sound effects enabled in settings
+- New default configuration: `classic-classic-full_sound_free_letters.json`
+- Deprecated configuration removed: `classic-classic-2.json`
 
 ### ✅ Challenge Mode
 - **Shareable challenge links** via short URLs (`?game_id=<sid>`)
@@ -124,6 +130,7 @@ Wrdler is a vocabulary learning game with a simplified grid and strategic letter
 - **Dockerfile-based deployment** supported for Hugging Face Spaces and other container platforms
 - **Environment variables** for Challenge Mode (HF_API_TOKEN, HF_REPO_ID, SPACE_NAME)
 - Works offline without HF credentials (Challenge Mode features disabled gracefully)
+- Footer navigation updated to prevent reloading active pages
 
 ### Progressive Web App (PWA)
 - Installable on desktop and mobile from your browser
@@ -218,7 +225,7 @@ MAX_DISPLAY_ENTRIES=25                 # Max leaderboard entries to display (def
  - `logic.py` – game mechanics (reveal, guess, scoring, free letters)
  - `ui.py` – Streamlit UI composition (with query-param routing and Settings/Leaderboard pages)
  - `oauth.py` – HuggingFace OAuth utilities (NEW)
- - `settings_page.py` – Settings page UI (implemented)
+ - `settings_page.py` – Settings page UI (enhanced: create, update, rename, delete settings)
  - `leaderboard.py` – Daily/weekly leaderboard system (v0.2.1)
  - `leaderboard_page.py` – Leaderboard UI page (v0.2.1)
  - `game_storage.py` – Hugging Face remote storage integration and challenge sharing
@@ -244,49 +251,58 @@ All test files must be placed in the `/tests` folder. This ensures a clean proje
 
 ## Changelog
 
-### v0.2.8 (Current) ✅
-**Settings Page & Local Settings Persistence (Settings Update)**
-- ✅ All game settings moved from sidebar to dedicated Settings page (`?page=settings`)
-- ✅ Settings accessible from footer navigation (`⚙️ Settings` link)
-- ✅ Local JSON-based settings persistence in `wrdler/settings/`
-- ✅ Latest settings automatically loaded on startup
-
-### v0.2.7 ✅
-**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.9 (Current) ✅
+- Bump version to 0.2.9
+- Enhanced settings management: create, update, rename, and delete settings files
+- Split "Save Settings" into "Create Settings" and "Update Settings" actions
+- Improved settings loading and user feedback
+- Default sound effects enabled in settings
+- Added `classic-classic-full_sound_free_letters.json`
+- Removed deprecated `classic-classic-2.json`
+- Footer navigation updated to prevent reloading active pages
+- Improved maintainability and usability
+
+### v0.2.8 (Settings Page & Local Settings Persistence)
+- All game settings moved from sidebar to dedicated Settings page (`?page=settings`)
+- Settings accessible from footer navigation (`⚙️ Settings` link)
+- Local JSON-based settings persistence in `wrdler/settings/`
+- Latest settings automatically loaded on startup
+
+### v0.2.7
+- 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)
-- ✅ Top 25 displayed entries per leaderboard
-- ✅ Four-tab leaderboard page (Today, Daily, Weekly, History)
-- ✅ Automatic score qualification and submission
-- ✅ Query parameter filtering for direct links (`?gidd=`, `?gidw=`)
-- ✅ Integration with challenge mode (source_challenge_id tracking)
-- ✅ Unified JSON format with entry_type field (daily/weekly/challenge)
-- ✅ Period-based organization: daily (YYYY-MM-DD), weekly (YYYY-Www)
-- ✅ Enhanced storage.py with folder listing capabilities
-- ✅ Updated scoring tiers with "Legendary" (45+)
-- ✅ Settings page planned (move from sidebar, OAuth login required)
+- Daily and Weekly Leaderboards Improved
+- Settings-based leaderboard separation (unique leaderboards per settings combo)
+- Folder-based discovery system (no index.json)
+- Top 25 displayed entries per leaderboard
+- Four-tab leaderboard page (Today, Daily, Weekly, History)
+- Automatic score qualification and submission
+- Query parameter filtering for direct links (`?gidd=`, `?gidw=`)
+- Integration with challenge mode (source_challenge_id tracking)
+- Unified JSON format with entry_type field (daily/weekly/challenge)
+- Period-based organization: daily (YYYY-MM-DD), weekly (YYYY-Www)
+- Enhanced storage.py with folder listing capabilities
+- Updated scoring tiers with "Legendary" (45+)
+- Settings page planned (move from sidebar, OAuth login required)
 
 ### v0.1.1
-- ✅ Enhanced AI word generation with intelligent word saving
-- ✅ Automatic retry mechanism for insufficient word counts (up to 3 retries)
-- ✅ 1000-word file size limit to prevent dictionary bloat
-- ✅ Improved new word detection (separates existing vs. new words before saving)
-- ✅ Better HF Space API integration with graceful fallback to local models
-- ✅ Additional word generation when initial pass doesn't meet MIN_REQUIRED threshold
-- ✅ Enhanced logging for word generation pipeline visibility
+- Enhanced AI word generation with intelligent word saving
+- Automatic retry mechanism for insufficient word counts (up to 3 retries)
+- 1000-word file size limit to prevent dictionary bloat
+- Improved new word detection (separates existing vs. new words before saving)
+- Better HF Space API integration with graceful fallback to local models
+- Additional word generation when initial pass doesn't meet MIN_REQUIRED threshold
+- Enhanced logging for word generation pipeline visibility
 
 ### v0.1.0
-- ✅ AI word generation functionality added
-- ✅ Topic-based custom word list creation
-- ✅ Dual generation modes (HF Space API + local transformers)
-- ✅ Utility modules integration (storage, file_utils, constants)
-- ✅ Documentation synchronized across all files
+- AI word generation functionality added
+- Topic-based custom word list creation
+- Dual generation modes (HF Space API + local transformers)
+- Utility modules integration (storage, file_utils, constants)
+- Documentation synchronized across all files
 
 ### v0.0.8
  - remove background animation

specs/specs.md

@@ -1,8 +1,8 @@
 # Wrdler Specifications
 
-**Version:** 0.2.8
+**Version:** 0.2.9
 
-**Status:** Production Ready - Leaderboards & Settings Page Implemented
+**Status:** Production Ready - Leaderboards & Enhanced Settings Page Implemented
 **Last Updated:** 2025-12-09
 
 ## Overview
@@ -63,42 +63,51 @@ 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.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
-- ✅ **Dual Generation Modes:**
+## Implemented Features (v0.2.9)
+
+### Settings Management (v0.2.9)
+- Enhanced settings management: create, update, rename, and delete settings files
+- Split "Save Settings" into "Create Settings" and "Update Settings" actions
+- Improved settings loading and user feedback
+- Default sound effects enabled in settings
+- New default configuration: `classic-classic-full_sound_free_letters.json`
+- Deprecated configuration removed: `classic-classic-2.json`
+- Footer navigation updated to prevent reloading active pages
+
+### Word List Management
+- **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
+- **Topic-Based Generation:** Create custom word lists for any theme using AI
+- **Dual Generation Modes:**
   - HF Space API (primary): Uses Hugging Face Space when `USE_HF_WORDS=true`
   - Local transformers (fallback): Falls back to local models if HF unavailable
-- ✅ **Intelligent Word Management:**
+- **Intelligent Word Management:**
   - Smart detection separates existing dictionary words from new AI-generated words
   - Only saves new words to prevent duplicates in word files
   - Automatic retry mechanism (up to 3 attempts) if insufficient words generated
   - 1000-word file size limit prevents dictionary bloat
   - Auto-sorted by length then alphabetically
-- ✅ **Guaranteed Distribution:** Ensures exactly 25 words each of lengths 4, 5, and 6
-- ✅ **Graceful Fallback:** Uses dictionary words if AI generation fails
-- ✅ **Enhanced Logging:** Detailed pipeline visibility for debugging
+- **Guaranteed Distribution:** Ensures exactly 25 words each of lengths 4, 5, and 6
+- **Graceful Fallback:** Uses dictionary words if AI generation fails
+- **Enhanced Logging:** Detailed pipeline visibility for debugging
 
 ### Challenge Mode
-- ✅ **Game ID Sharing:** Each puzzle generates a shareable link with `?game_id=<sid>` to challenge others with the same word list
-- ✅ **Remote Storage:** Game results and leaderboards stored in Hugging Face dataset repos
-- ✅ **Leaderboards:** Multi-user leaderboards sorted by score (descending) then time (ascending)
-- ✅ **Word List Difficulty:** Calculated and displayed for each challenge
-- ✅ **Top 5 Display:** Leaderboard banner shows top 5 players
-- ✅ **Optional Sharing:** "Show Challenge Share Links" toggle (default OFF) controls URL visibility
+- **Game ID Sharing:** Each puzzle generates a shareable link with `?game_id=<sid>` to challenge others with the same word list
+- **Remote Storage:** Game results and leaderboards stored in Hugging Face dataset repos
+- **Leaderboards:** Multi-user leaderboards sorted by score (descending) then time (ascending)
+- **Word List Difficulty:** Calculated and displayed for each challenge
+- **Top 5 Display:** Leaderboard banner shows top 5 players
+- **Optional Sharing:** "Show Challenge Share Links" toggle (default OFF) controls URL visibility
 
 ### Leaderboard System (v0.2.1) ✅ IMPLEMENTED
 Wrdler features a comprehensive daily and weekly leaderboard system:
 
 **Core Features:**
-- **Daily Leaderboards:** Top 20 scores for each day (resets UTC midnight)
-- **Weekly Leaderboards:** Top 20 scores for each ISO week (resets Monday UTC 00:00)
+- **Daily Leaderboards:** Top 25 scores for each day (resets UTC midnight)
+- **Weekly Leaderboards:** Top 25 scores for each ISO week (resets Monday UTC 00:00)
 - **Settings-Based Separation:** Each unique combination of game-affecting settings creates a separate leaderboard:
   - `game_mode` (classic, easy, too easy)
   - `wordlist_source` (classic.txt, fourth_grade.txt, etc.)
@@ -157,14 +166,15 @@ HF_REPO_ID/games/
 **Access:** 'Leaderboard' link in the footer navigation at the bottom of the page
 
 ### PWA Support
-- ✅ **PWA Installation:** App is installable as a Progressive Web App on desktop and mobile
+- **PWA Installation:** App is installable as a Progressive Web App on desktop and mobile
   - Added `service worker` and `manifest.json`
   - Basic offline caching of static assets
   - INSTALL_GUIDE.md added with platform-specific install steps
   - No gameplay logic changes
 
-### Settings Page (v0.2.8)
+### Settings Page (v0.2.8+)
  - All game settings moved from sidebar to a dedicated settings page (`?page=settings`)
  - Accessible via the footer navigation (`⚙️ Settings` link)
  - Controls game mode, word list selection, grid options (spacer, grid ticks), and audio (music and sound effects)
  - Settings are persisted to JSON files in `wrdler/settings/` and the latest settings are loaded on app startup
+ - Enhanced management: create, update, rename, delete settings files

wrdler/__init__.py

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

wrdler/local_storage.py

@@ -219,18 +219,10 @@ def generate_settings_filename(settings: dict) -> str:
     
     return f"{safe_mode}-{safe_wordlist}-{spacer}.json"
 
-def save_settings_configuration(settings: dict) -> str:
+def _prepare_settings_for_save(settings: dict) -> dict:
     """
-    Saves the provided settings dictionary to a JSON file in wrdler/settings/.
-    Ensures compatibility with leaderboard settings format.
-    Also writes a copy to settings/settings.json as the canonical latest settings.
-    Returns the filename used.
+    Helper to transform local settings into the compatible storage format.
     """
-    ensure_settings_dir()
-    filename = generate_settings_filename(settings)
-    filepath = os.path.join(SETTINGS_DIR, filename)
-
-    # Transform to compatible format
     compatible_settings = settings.copy()
 
     # Normalize music track path to be relative for portability
@@ -263,17 +255,60 @@ def save_settings_configuration(settings: dict) -> str:
         compatible_settings["victory_sound"] = _to_relative_music_path(compatible_settings["victory_sound"])
     if "defeat_sound" in compatible_settings:
         compatible_settings["defeat_sound"] = _to_relative_music_path(compatible_settings["defeat_sound"])
+    
+    return compatible_settings
+
+def save_active_settings(settings: dict) -> None:
+    """
+    Saves the provided settings dictionary to settings/settings.json only.
+    This sets the current active settings without creating or updating a named configuration file.
+    """
+    ensure_settings_dir()
+    compatible_settings = _prepare_settings_for_save(settings)
+    canonical_path = os.path.join(SETTINGS_DIR, "settings.json")
+    with open(canonical_path, "w", encoding="utf-8") as f:
+        json.dump(compatible_settings, f, indent=2, ensure_ascii=False)
+
+def save_settings_configuration(settings: dict) -> str:
+    """
+    Saves the provided settings dictionary to a JSON file in wrdler/settings/.
+    Ensures compatibility with leaderboard settings format.
+    Also writes a copy to settings/settings.json as the canonical latest settings.
+    Returns the filename used.
+    """
+    ensure_settings_dir()
+    filename = generate_settings_filename(settings)
+    filepath = os.path.join(SETTINGS_DIR, filename)
+
+    compatible_settings = _prepare_settings_for_save(settings)
         
     with open(filepath, "w", encoding="utf-8") as f:
         json.dump(compatible_settings, f, indent=2, ensure_ascii=False)
 
     # --- Write to canonical settings.json ---
-    canonical_path = os.path.join(SETTINGS_DIR, "settings.json")
-    with open(canonical_path, "w", encoding="utf-8") as f:
-        json.dump(compatible_settings, f, indent=2, ensure_ascii=False)
+    save_active_settings(settings)
 
     return filename
 
+def edit_settings_configuration(filename: str, settings: dict) -> str:
+    """
+    Overwrites the specified settings file in wrdler/settings/ with the provided settings dict.
+    Also updates settings/settings.json as the canonical latest settings.
+    Returns the filename used.
+    """
+    ensure_settings_dir()
+    filepath = os.path.join(SETTINGS_DIR, filename)
+    
+    compatible_settings = _prepare_settings_for_save(settings)
+    
+    with open(filepath, "w", encoding="utf-8") as f:
+        json.dump(compatible_settings, f, indent=2, ensure_ascii=False)
+        
+    # --- Write to canonical settings.json ---
+    save_active_settings(settings)
+    
+    return filename
+
 def load_settings_configuration(filename: str) -> dict:
     """
     Loads settings from a specific file in wrdler/settings/.

wrdler/settings/classic-classic-1.json

@@ -11,7 +11,7 @@
   "music_enabled": false,
   "music_volume": 15,
   "effects_volume": 25,
-  "enable_sound_effects": false,
+  "enable_sound_effects": true,
   "music_track_path": "background.mp3",
   "wordlist_source": "classic.txt",
   "puzzle_options": {

wrdler/settings/settings.json

@@ -11,7 +11,7 @@
   "music_enabled": false,
   "music_volume": 15,
   "effects_volume": 25,
-  "enable_sound_effects": false,
+  "enable_sound_effects": true,
   "music_track_path": "background.mp3",
   "wordlist_source": "classic.txt",
   "puzzle_options": {

wrdler/settings_page.py

@@ -5,7 +5,8 @@ from .word_loader import get_wordlist_files, get_wordlist_info
 from .generator import sort_word_file, filter_word_file
 from .audio import get_audio_tracks, _inject_audio_control_sync
 from .version_info import versions_html
-from .local_storage import save_settings_configuration, load_settings_configuration, list_settings_configurations, load_latest_settings
+from .local_storage import save_settings_configuration, load_settings_configuration, list_settings_configurations, load_latest_settings, save_active_settings
+import shutil
 
 # Keys that should persist across sessions when saving settings
 _PERSISTED_SETTING_KEYS = (
@@ -117,16 +118,19 @@ def _filter_wordlist(filename):
         st.info(f"No words removed from {filename}.")
 
 def render_settings_page(new_game_callback):
-    # --- Always load settings.json on entry and apply to session state ---
-    latest_settings = load_latest_settings()
-    rerun_needed = False
-    if latest_settings:
-        for key, value in latest_settings.items():
-            if st.session_state.get(key) != value:
-                st.session_state[key] = value
-                rerun_needed = True
-    if rerun_needed:
-        st.rerun()
+    # Only load settings.json if forced or on first load
+    if st.session_state.get("_settings_force_reload", False) or not st.session_state.get("_settings_first_load", False):
+        latest_settings = load_latest_settings()
+        rerun_needed = False
+        if latest_settings:
+            for key, value in latest_settings.items():
+                if st.session_state.get(key) != value:
+                    st.session_state[key] = value
+                    rerun_needed = True
+        st.session_state["_settings_first_load"] = True
+        st.session_state["_settings_force_reload"] = False
+        if rerun_needed:
+            st.rerun()
 
     st.header("SETTINGS")
 
@@ -177,11 +181,46 @@ def render_settings_page(new_game_callback):
                     st.session_state["_settings_snapshot"] = loaded_settings
                     st.session_state["_settings_apply_pending"] = True
                     st.session_state["_settings_saved_notice"] = f"Loaded configuration: {selected_config}"
-                    # Overwrite settings.json with the loaded configuration
-                    save_settings_configuration(loaded_settings)
+                    # Update settings.json with the loaded configuration (active settings)
+                    save_active_settings(loaded_settings)
+                    st.session_state["_settings_force_reload"] = True
+                    st.session_state["_settings_loaded_file"] = selected_config  # Track loaded file for Edit/Delete/Rename
+                    st.session_state["rename_settings_text"] = selected_config
                     st.rerun()
     else:
         st.caption("No saved configurations found.")
+    # --- Rename and Delete Section ---
+    selected_file = st.session_state.get("_settings_loaded_file")
+    if not selected_file:
+        selected_file = "settings.json" if os.path.exists(os.path.join(SETTINGS_DIR, "settings.json")) else None
+    if selected_file and not st.session_state.get("rename_settings_text"):
+        st.session_state["rename_settings_text"] = selected_file
+    st.markdown("**Current Settings File:**")
+    file_to_rename = st.text_input("File Name", value=st.session_state.get("rename_settings_text", ""), key="rename_settings_text")
+    col_rename, col_delete = st.columns(2)
+    with col_rename:
+        rename_disabled = not selected_file or selected_file == "Select..." or not file_to_rename or file_to_rename == selected_file
+        if st.button("Rename Settings", key="rename_settings_btn", disabled=rename_disabled):
+            src = os.path.join(SETTINGS_DIR, selected_file)
+            dst = os.path.join(SETTINGS_DIR, file_to_rename)
+            if os.path.exists(src) and not os.path.exists(dst):
+                try:
+                    shutil.move(src, dst)
+                    st.session_state["_settings_saved_notice"] = f"Renamed {selected_file} to {file_to_rename}."
+                    st.session_state["_settings_loaded_file"] = file_to_rename
+                except Exception as e:
+                    st.session_state["_settings_save_error"] = f"Rename failed: {e}"
+                st.rerun()
+    with col_delete:
+        delete_disabled = not selected_file or selected_file == "Select..." or selected_file == "settings.json"
+        if st.button("Delete Settings", key="delete_settings_btn", disabled=delete_disabled):
+            try:
+                os.remove(os.path.join(SETTINGS_DIR, selected_file))
+                st.session_state["_settings_saved_notice"] = f"Deleted {selected_file}."
+                st.session_state["_settings_loaded_file"] = None
+            except Exception as e:
+                st.session_state["_settings_save_error"] = f"Delete failed: {e}"
+            st.rerun()
     st.markdown("---")
 
     st.header("Game Mode")
@@ -461,36 +500,78 @@ def render_settings_page(new_game_callback):
     else:
         st.caption("Place .mp3 files in wrdler/assets/audio/music to enable music.")
 
-    # --- Save Settings button (must be outside any form or column context) ---
+    # --- Settings buttons (Create/Update) ---
     settings_snapshot = {key: st.session_state.get(key) for key in _PERSISTED_SETTING_KEYS}
-    if st.button("Save Settings", key="save_settings_btn", help="Apply settings and start a new game with them"):
-        # Check if settings file already exists
-        existing_file = _settings_file_exists(settings_snapshot)
-        if not existing_file:
-            # Generate base name (e.g., classic-classic)
-            mode = settings_snapshot.get("game_mode", "classic")
-            if settings_snapshot.get("use_ai_wordlist"):
-                topic = settings_snapshot.get("ai_topic", "English").strip().replace(" ", "_")
-                topic = "".join(c for c in topic if c.isalnum() or c in ('-', '_'))
-                wordlist_part = f"ai-{topic}"
-            else:
-                w_file = settings_snapshot.get("selected_wordlist", "classic.txt")
-                wordlist_part = os.path.splitext(os.path.basename(w_file))[0]
-            base_name = f"{mode}-{wordlist_part}"
-            filename = _get_next_settings_filename(base_name)
-            # Save to new file and always update settings.json
-            save_settings_configuration(settings_snapshot)
-            # Rename the just-written file to the new unique filename
-            os.rename(os.path.join(SETTINGS_DIR, save_settings_configuration(settings_snapshot)), os.path.join(SETTINGS_DIR, filename))
-            st.session_state["_settings_saved_notice"] = f"Settings saved to {filename}!"
+    existing_file = _settings_file_exists(settings_snapshot)
+    
+    def _create_settings_callback(snapshot):
+        mode = snapshot.get("game_mode", "classic")
+        if snapshot.get("use_ai_wordlist"):
+            topic = snapshot.get("ai_topic", "English").strip().replace(" ", "_")
+            topic = "".join(c for c in topic if c.isalnum() or c in ('-', '_'))
+            wordlist_part = f"ai-{topic}"
         else:
-            # Always update settings.json
-            save_settings_configuration(settings_snapshot)
-            st.session_state["_settings_saved_notice"] = f"Settings already exists as {existing_file}. settings.json updated."
-        st.session_state["_settings_snapshot"] = settings_snapshot
+            w_file = snapshot.get("selected_wordlist", "classic.txt")
+            wordlist_part = os.path.splitext(os.path.basename(w_file))[0]
+        base_name = f"{mode}-{wordlist_part}"
+        filename = _get_next_settings_filename(base_name)
+        
+        new_filename = save_settings_configuration(snapshot)
+        if new_filename != filename:
+            src = os.path.join(SETTINGS_DIR, new_filename)
+            dst = os.path.join(SETTINGS_DIR, filename)
+            try:
+                if os.path.exists(src) and not os.path.exists(dst):
+                    with open(src, "r", encoding="utf-8") as fsrc, open(dst, "w", encoding="utf-8") as fdst:
+                        fdst.write(fsrc.read())
+            except Exception:
+                pass
+        
+        st.session_state["_settings_saved_notice"] = f"Settings created as {filename}!"
+        st.session_state["_settings_snapshot"] = snapshot
         st.session_state["_settings_apply_pending"] = True
         st.session_state.pop("_settings_save_error", None)
-        st.rerun()
+        st.session_state["_settings_force_reload"] = True
+        st.session_state["_settings_loaded_file"] = filename
+        st.session_state["rename_settings_text"] = filename
+
+    def _update_settings_callback(file_name, snapshot):
+        from .local_storage import edit_settings_configuration
+        edit_settings_configuration(file_name, snapshot)
+        st.session_state["_settings_saved_notice"] = f"Settings updated in {file_name}!"
+        st.session_state["_settings_snapshot"] = snapshot
+        st.session_state["_settings_apply_pending"] = True
+        st.session_state.pop("_settings_save_error", None)
+        st.session_state["_settings_force_reload"] = True
+        st.session_state["_settings_loaded_file"] = file_name
+        st.session_state["rename_settings_text"] = file_name
+
+    col_create, col_update = st.columns(2)
+    with col_create:
+        st.button(
+            "Create Settings", 
+            key="create_settings_btn", 
+            help="Create a new settings file and set as latest",
+            on_click=_create_settings_callback,
+            args=(settings_snapshot,)
+        )
+
+    with col_update:
+        # Use loaded file for update if available, else fallback to config match
+        update_file = st.session_state.get("_settings_loaded_file") or existing_file
+        update_disabled = not update_file or update_file == "Select..."
+        
+        st.button(
+            "Update Settings", 
+            key="update_settings_btn", 
+            help="Update the existing settings file and set as latest", 
+            disabled=update_disabled,
+            on_click=_update_settings_callback,
+            args=(update_file, settings_snapshot)
+        )
+        
+        if update_disabled:
+            st.caption("No matching settings file to update.")
 
     _inject_audio_control_sync()
     st.markdown(versions_html(), unsafe_allow_html=True)

wrdler/ui.py

@@ -2278,13 +2278,13 @@ def _render_footer(current_page: str = "play"):
             }}
         }}
         </style>
-        <div class="bw-footer">
-            <nav class="bw-footer-nav">
-                <a href="{leaderboard_url}" title="View Leaderboards" target="_self" class="{leaderboard_active}">🏆 Leaderboard</a>
-                <a href="{play_url}" title="Play Wrdler" target="_self" class="{play_active}">🎮 Play</a>
-                <a href="{settings_url}" title="Settings" target="_self" class="{settings_active}">⚙️ Settings</a>
-            </nav>
-        </div>
+    <div class="bw-footer">
+        <nav class="bw-footer-nav">
+            <a href="{leaderboard_url if not leaderboard_active else '#'}" title="View Leaderboards" target="_self" class="{leaderboard_active}">🏆 Leaderboard</a>
+            <a href="{play_url if not play_active else '#'}" title="Play Wrdler" target="_self" class="{play_active}">🎮 Play</a>
+            <a href="{settings_url if not settings_active else '#'}" title="Settings" target="_self" class="{settings_active}">⚙️ Settings</a>
+        </nav>
+    </div>
         """,
         unsafe_allow_html=True,
     )