diff --git a/.Jules/palette.md b/.Jules/palette.md index 8ee612f..4c4abd7 100644 --- a/.Jules/palette.md +++ b/.Jules/palette.md @@ -12,3 +12,7 @@ ## 2025-03-23 - Game Key Scrolling **Learning:** Browsers natively scroll the page when users press Space or Arrow keys. When building a web-based game, this creates a frustrating UX where the game viewport jumps around while playing. **Action:** Always call `e.preventDefault()` on keydown events for typical game controls ("Space", "ArrowUp", etc.) when the focus is on a game container or the body. + +## 2024-05-23 - Interactive Game UI Controls & Screen Readers +**Learning:** Interactive HTML5 games often lack visible control hints, frustrating users who must guess keyboard bindings. Additionally, dynamically updated UI elements like score counters are silent to screen readers by default. +**Action:** Always add explicit, visual instructions for custom key bindings (like "Press Space to jump") and use `aria-live="polite"` and `aria-atomic="true"` on elements with dynamic textual updates (like game scores) to ensure accessibility. diff --git a/requirements.txt b/requirements.txt index cfaa995..4ad1501 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,4 +1,3 @@ numpy pandas requests -venv diff --git a/src/views/mario-game.njk b/src/views/mario-game.njk index 67b6bd7..b64b2db 100644 --- a/src/views/mario-game.njk +++ b/src/views/mario-game.njk @@ -52,13 +52,23 @@ font-size: 20px; font-family: Arial; } + + #instructions { + position: absolute; + top: 40px; + left: 10px; + color: rgba(255, 255, 255, 0.8); + font-size: 14px; + font-family: Arial; + }
-
Score: 0
+
Score: 0
+
Press Space or ↑ to jump