From 04353942682fa158ae1949780babee09f8e8ab68 Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Wed, 10 Jun 2026 13:33:29 +0000 Subject: [PATCH 1/2] UX: Add explicit keyboard instructions and score accessibility to Mario game Co-authored-by: EiJackGH <172181576+EiJackGH@users.noreply.github.com> --- .Jules/palette.md | 4 ++++ src/views/mario-game.njk | 13 ++++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/.Jules/palette.md b/.Jules/palette.md index 8ee612f..8da24d7 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. + +## 2025-06-10 - Screen Reader Redundancy with aria-live +**Learning:** Placing static instructional text ("Press Space to jump") inside an `aria-live` region alongside dynamic content (like a "Score: 0" counter) forces screen readers to re-read the static instructions every time the score updates, creating a frustrating experience. +**Action:** Extract static text into a separate sibling element, applying `aria-live` strictly to the container wrapping only the dynamic text. diff --git a/src/views/mario-game.njk b/src/views/mario-game.njk index 67b6bd7..19d1a39 100644 --- a/src/views/mario-game.njk +++ b/src/views/mario-game.njk @@ -52,13 +52,24 @@ font-size: 20px; font-family: Arial; } + + #instructions { + position: absolute; + top: 40px; + left: 10px; + color: #eeeeee; + font-size: 14px; + font-family: Arial; + opacity: 0.8; + }
-
Score: 0
+
Score: 0
+
Press Space or Up Arrow to jump
From eb1a70a46569474057bbcb397e56c5d9fac80545 Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Wed, 10 Jun 2026 13:38:02 +0000 Subject: [PATCH 2/2] UX: Add explicit keyboard instructions and score accessibility to Mario game, Fix CI Co-authored-by: EiJackGH <172181576+EiJackGH@users.noreply.github.com> --- requirements.txt | 1 - 1 file changed, 1 deletion(-) 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