From 2ff5426a30a96056b5563c6825de31d42728b0a4 Mon Sep 17 00:00:00 2001
From: Andras Schmelczer <andras@schmelczer.dev>
Date: Tue, 15 Sep 2026 20:33:25 +0100
Subject: [PATCH] smarter tutorial

---
 frontend/src/scripts/tutorial.ts | 28 ++++++++++++++++++++++------
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/frontend/src/scripts/tutorial.ts b/frontend/src/scripts/tutorial.ts
index e227c71..e495800 100644
--- a/frontend/src/scripts/tutorial.ts
+++ b/frontend/src/scripts/tutorial.ts
@@ -13,10 +13,18 @@ import { PlanetView } from './objects/types/planet-view';
 
 type StageTrigger = 'move' | 'shoot' | 'leap' | 'capture';
 
-const stages: ReadonlyArray<{ hint: string; clearsOn: StageTrigger }> = [
-  { hint: 'WASD / drag to walk', clearsOn: 'move' },
-  { hint: 'Click / tap to shoot', clearsOn: 'shoot' },
-  { hint: 'Space / leap button to launch off a planet', clearsOn: 'leap' },
+const stages: ReadonlyArray<{
+  hint: string;
+  touchHint?: string;
+  clearsOn: StageTrigger;
+}> = [
+  { hint: 'WASD to walk', touchHint: 'Drag to walk', clearsOn: 'move' },
+  { hint: 'Click to shoot', touchHint: 'Tap to shoot', clearsOn: 'shoot' },
+  {
+    hint: 'Space to launch off a planet',
+    touchHint: 'Tap the leap button to launch off a planet',
+    clearsOn: 'leap',
+  },
   { hint: 'Stand on a planet to capture it', clearsOn: 'capture' },
 ];
 
@@ -54,7 +62,7 @@ export class Tutorial extends CommandReceiver {
   constructor(overlay: HTMLElement) {
     super();
     this.element.className = 'tutorial-hint';
-    this.element.innerText = stages[0].hint;
+    this.setStage(0);
     overlay.appendChild(this.element);
   }
 
@@ -107,6 +115,14 @@ export class Tutorial extends CommandReceiver {
 
   private setStage(stage: number) {
     this.stage = stage;
-    this.element.innerText = stages[stage]?.hint ?? '';
+    // Keep the hints consistent with the touch buttons' visibility in main.scss.
+    const useTouchControls = window.matchMedia(
+      '(hover: none) and (pointer: coarse)',
+    ).matches;
+    const currentStage = stages[stage];
+    this.element.innerText =
+      (useTouchControls ? currentStage?.touchHint : undefined) ??
+      currentStage?.hint ??
+      '';
   }
 }