From c5f006e47f3747554528190def1de933e4dd84df Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Tue, 19 May 2026 13:16:36 +0000 Subject: [PATCH] feat: improve mario game accessibility and UX - Add explicit keyboard control instructions to the UI - Add aria-live region to the score element for screen reader announcements - Fix broken requirements.txt preventing CI/local pip installation Co-authored-by: EiJackGH <172181576+EiJackGH@users.noreply.github.com> --- .Jules/palette.md | 3 +++ requirements.txt | 1 - src/views/mario-game.njk | 12 +++++++++++- 3 files changed, 14 insertions(+), 2 deletions(-) diff --git a/.Jules/palette.md b/.Jules/palette.md index 8ee612f..897e364 100644 --- a/.Jules/palette.md +++ b/.Jules/palette.md @@ -12,3 +12,6 @@ ## 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. +## 2026-05-19 - Screen Reader Support for Real-Time Game UI Updates +**Learning:** Dynamic UI elements in HTML5 games (like a live score counter) are completely invisible to screen readers by default. +**Action:** Always add `aria-live="polite"` and `aria-atomic="true"` to game status elements (scores, health, timers) so screen readers automatically announce changes. 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..feab673 100644 --- a/src/views/mario-game.njk +++ b/src/views/mario-game.njk @@ -52,13 +52,23 @@ font-size: 20px; font-family: Arial; } + + #controls-hint { + 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