From 663460d62ed87d5ebcb3679a733f67a1499b959e Mon Sep 17 00:00:00 2001
From: Davide Grilli <davide.grilli@outlook.com>
Date: Tue, 7 Jul 2026 22:35:19 +0200
Subject: [PATCH] feat(ui): add user guide button to help overlay

Adds a "User guide" button next to "Report a bug" in the Help > Info
tab, linking to USERGUIDE.md on GitHub via the same Launcher pattern
used for bug reports and release pages.
---
 src/App/Localization/Loc.cs     |  1 +
 src/App/Views/MainView.axaml    | 11 ++++++++---
 src/App/Views/MainView.axaml.cs |  8 ++++++++
 3 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/src/App/Localization/Loc.cs b/src/App/Localization/Loc.cs
index a61c25b..06f0c97 100644
--- a/src/App/Localization/Loc.cs
+++ b/src/App/Localization/Loc.cs
@@ -63,6 +63,7 @@ public sealed class Loc
         ["help.tab.info"]         = ["Info",                                                               "Info",                         "Info",                                 "Info",                                     "Info",                                     "Info"],
         ["help.tab.donate"]       = ["Dona",                                                               "Donate",                       "Donar",                                "Faire un don",                             "Doar",                                     "Spenden"],
         ["help.bug.report"]       = ["Segnala un bug",                                                     "Report a bug",                 "Informar un error",                    "Signaler un bug",                          "Reportar um bug",                          "Fehler melden"],
+        ["help.user.guide"]       = ["Guida utente",                                                       "User guide",                   "Guía del usuario",                     "Guide utilisateur",                        "Guia do usuário",                          "Benutzerhandbuch"],
         ["update.title"]          = ["Aggiornamento disponibile",                                          "Update available",             "Actualización disponible",             "Mise à jour disponible",                   "Atualização disponível",                   "Update verfügbar"],
         ["update.message"]        = ["È disponibile una nuova versione:",                                  "A new version is available:",  "Hay una nueva versión disponible:",    "Une nouvelle version est disponible :",    "Uma nova versão está disponível:",         "Eine neue Version ist verfügbar:"],
         ["update.download"]       = ["Scarica",                                                            "Download",                     "Descargar",                            "Télécharger",                              "Baixar",                                   "Herunterladen"],
diff --git a/src/App/Views/MainView.axaml b/src/App/Views/MainView.axaml
index 72f8518..6b4891f 100644
--- a/src/App/Views/MainView.axaml
+++ b/src/App/Views/MainView.axaml
@@ -1563,9 +1563,14 @@
                                                    Foreground="{DynamicResource TextSecondaryBrush}"/>
                                     </StackPanel>
                                     <TextBlock Text="{Binding Loc[help.info]}" TextWrapping="Wrap"/>
-                                    <Button Content="{Binding Loc[help.bug.report]}"
-                                            Click="OnOpenBugReportClick"
-                                            HorizontalAlignment="Left"/>
+                                    <StackPanel Orientation="Horizontal" Spacing="8">
+                                        <Button Content="{Binding Loc[help.bug.report]}"
+                                                Click="OnOpenBugReportClick"
+                                                HorizontalAlignment="Left"/>
+                                        <Button Content="{Binding Loc[help.user.guide]}"
+                                                Click="OnOpenUserGuideClick"
+                                                HorizontalAlignment="Left"/>
+                                    </StackPanel>
                                     <Border BorderBrush="{DynamicResource BorderSubtleBrush}"
                                             BorderThickness="0,1,0,0" Margin="0,4,0,0"/>
                                     <StackPanel Spacing="4">
diff --git a/src/App/Views/MainView.axaml.cs b/src/App/Views/MainView.axaml.cs
index 322089c..795d871 100644
--- a/src/App/Views/MainView.axaml.cs
+++ b/src/App/Views/MainView.axaml.cs
@@ -144,6 +144,14 @@ public partial class MainView : UserControl
             await launcher.LaunchUriAsync(new Uri(issueUrl));
     }
 
+    private async void OnOpenUserGuideClick(object? sender, RoutedEventArgs e)
+    {
+        const string userGuideUrl = "https://github.com/davide3011/PalladiumWallet/blob/main/USERGUIDE.md";
+        var launcher = TopLevel.GetTopLevel(this)?.Launcher;
+        if (launcher is not null)
+            await launcher.LaunchUriAsync(new Uri(userGuideUrl));
+    }
+
     private async void OnOpenReleasePageClick(object? sender, RoutedEventArgs e)
     {
         if (DataContext is not MainWindowViewModel vm || string.IsNullOrEmpty(vm.UpdateReleaseUrl)) return;