From 7846f69b592c5348c0a4fe6581323bc4b3b87cb6 Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Sun, 10 May 2026 13:10:54 +0000 Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20[UX=20improvement]=20?= =?UTF-8?q?Add=20game=20instructions=20and=20accessibility=20enhancements?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds explicit "Press Space or ↑ to Jump" instructions to the Mario game UI so users understand the controls intuitively. Also adds `aria-live="polite"` and `aria-atomic="true"` to the score counter to announce updates to screen readers. Removes problematic `venv` entry from `requirements.txt`. Co-authored-by: EiJackGH <172181576+EiJackGH@users.noreply.github.com> --- .Jules/palette.md | 4 ++++ requirements.txt | 1 - src/views/mario-game.njk | 12 +++++++++++- 3 files changed, 15 insertions(+), 2 deletions(-) diff --git a/.Jules/palette.md b/.Jules/palette.md index 8ee612f..6f0d270 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-10 - Screen Reader Accessibility for Dynamic Scores +**Learning:** Dynamic, JavaScript-updated scores or counters are entirely silent to screen readers by default. This makes game progression unobservable for visually impaired users. +**Action:** Always add `aria-live="polite"` and `aria-atomic="true"` to dynamic score or status elements to ensure real-time screen reader announcements without overwhelming the user. 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..e7306a7 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.9); + font-size: 16px; + font-family: Arial, sans-serif; + }
-
Score: 0
+
Score: 0
+
Press Space or ↑ to Jump