From 2175a25d700be020305fa7fb4a09011adb2414cc Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Wed, 22 Jul 2026 13:36:04 +0000 Subject: [PATCH] feat: add visible jump instructions to mario game - Added on-screen text to indicate Space or Up Arrow for jumping - Applied `pointer-events: none` to prevent the overlay from blocking interactions - Recorded UX learning in palette journal Co-authored-by: EiJackGH <172181576+EiJackGH@users.noreply.github.com> --- .Jules/palette.md | 4 ++++ src/views/mario-game.njk | 11 +++++++++++ 2 files changed, 15 insertions(+) diff --git a/.Jules/palette.md b/.Jules/palette.md index 8ee612f..6da7f63 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-05-18 - Visible Instructions for Custom Key Bindings +**Learning:** When building interactive HTML5 widgets or games with custom keyboard event bindings, users cannot intuit the required inputs on their own. +**Action:** Always provide explicit, visible instructional text so users know the required inputs (and use `pointer-events: none` if overlaying interactive content). diff --git a/src/views/mario-game.njk b/src/views/mario-game.njk index 67b6bd7..6037416 100644 --- a/src/views/mario-game.njk +++ b/src/views/mario-game.njk @@ -52,6 +52,16 @@ font-size: 20px; font-family: Arial; } + + #instructions { + position: absolute; + top: 10px; + right: 10px; + color: white; + font-size: 20px; + font-family: Arial; + pointer-events: none; + } @@ -59,6 +69,7 @@
Score: 0
+
Press Space or Up Arrow to jump