diff --git a/.Jules/palette.md b/.Jules/palette.md
index 8ee612f..92ecbbf 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-19 - Explicit Input Instructions for Web Games
+**Learning:** When building interactive HTML5 widgets or games with custom keyboard event bindings, users may not know the required inputs naturally. Relying on trial and error can be frustrating.
+**Action:** Always provide explicit, visible instructional text so users know the required inputs.
diff --git a/src/views/mario-game.njk b/src/views/mario-game.njk
index 67b6bd7..77c36a3 100644
--- a/src/views/mario-game.njk
+++ b/src/views/mario-game.njk
@@ -52,6 +52,17 @@
       font-size: 20px;
       font-family: Arial;
     }
+
+    #instructions {
+      position: absolute;
+      top: 40px;
+      left: 10px;
+      color: white;
+      font-size: 16px;
+      font-family: Arial;
+      pointer-events: none;
+      opacity: 0.8;
+    }
   </style>
 </head>
 
@@ -59,6 +70,7 @@
 
 <div id="game">
   <div id="score">Score: 0</div>
+  <div id="instructions">Press Space or Up Arrow to jump</div>
   <div id="mario"></div>
   <div class="ground"></div>
 </div>