From abeb4e5cdf48bd5b094a3c4c13e37da47376e36f Mon Sep 17 00:00:00 2001
From: funman300 <funman300@gmail.com>
Date: Thu, 30 Apr 2026 20:18:02 +0000
Subject: [PATCH] feat(engine): unify dismiss verb to Done and warm onboarding
 CTA to Let's play
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Help modal previously used "Close" while the other five overlay
modals (Home, Stats, Achievements, Settings, Profile, Leaderboard)
used "Done"; standardising on "Done" removes the outlier.

The final onboarding slide changes from "Start playing" to
"Let's play". The microcopy audit suggested matching the win modal's
"Play Again", but that verb is semantically wrong on first launch —
the player has not yet played. "Let's play" reads warmer and matches
the project's Balatro-tone direction without overloading "Play Again"
across two contexts that mean different things.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 solitaire_engine/src/help_plugin.rs       | 6 +++---
 solitaire_engine/src/onboarding_plugin.rs | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/solitaire_engine/src/help_plugin.rs b/solitaire_engine/src/help_plugin.rs
index fdb1a4d..9e4f32c 100644
--- a/solitaire_engine/src/help_plugin.rs
+++ b/solitaire_engine/src/help_plugin.rs
@@ -20,7 +20,7 @@ use crate::ui_theme::{
 #[derive(Component, Debug)]
 pub struct HelpScreen;
 
-/// Marker on the "Close" button inside the Help modal.
+/// Marker on the "Done" button inside the Help modal.
 #[derive(Component, Debug)]
 pub struct HelpCloseButton;
 
@@ -56,7 +56,7 @@ fn toggle_help_screen(
     }
 }
 
-/// Click handler for the modal's "Close" button. F1 toggles the overlay
+/// Click handler for the modal's "Done" button. F1 toggles the overlay
 /// the same way; this just exposes the close action to mouse / touch.
 fn handle_help_close_button(
     mut commands: Commands,
@@ -194,7 +194,7 @@ fn spawn_help_screen(commands: &mut Commands, font_res: Option<&FontResource>) {
             spawn_modal_button(
                 actions,
                 HelpCloseButton,
-                "Close",
+                "Done",
                 Some("F1"),
                 ButtonVariant::Primary,
                 font_res,
diff --git a/solitaire_engine/src/onboarding_plugin.rs b/solitaire_engine/src/onboarding_plugin.rs
index 53f643f..5ed465e 100644
--- a/solitaire_engine/src/onboarding_plugin.rs
+++ b/solitaire_engine/src/onboarding_plugin.rs
@@ -166,7 +166,7 @@ fn handle_onboarding_buttons(
     }
 
     if skip_pressed || (next_pressed && slide_index.0 == SLIDE_COUNT - 1) {
-        // Skip or final-slide "Start playing" — complete onboarding.
+        // Skip or final-slide "Let's play" — complete onboarding.
         complete_onboarding(
             &mut commands,
             &screens,
@@ -412,7 +412,7 @@ fn spawn_slide_hotkeys(commands: &mut Commands, font_res: Option<&FontResource>)
             spawn_modal_button(
                 actions,
                 OnboardingNextButton,
-                "Start playing",
+                "Let's play",
                 Some("→"),
                 ButtonVariant::Primary,
                 font_res,