feat: Add first run banner and localization updates for Compact theme

CopyPaste.Core/MyMConfig.cs

@@ -37,7 +37,13 @@ public sealed class MyMConfig
     /// ID of the active theme (e.g., "copypaste.default").
     /// Must match <see cref="CopyPaste.Core.Themes.ITheme.Id"/>.
     /// </summary>
-    public string ThemeId { get; set; } = "copypaste.default";
+    public string ThemeId { get; set; } = "copypaste.compact";
+
+    /// <summary>
+    /// Whether the user has already seen (and dismissed) the theme discovery hint in Settings.
+    /// Once true, the hint banner is never shown again.
+    /// </summary>
+    public bool HasSeenThemeHint { get; set; }
 
     // ═══════════════════════════════════════════════════════════════
     // Hotkey Configuration

CopyPaste.UI/App.xaml.cs

@@ -87,6 +87,7 @@
         InitializeCoreServices();
 
         var config = _engine!.Config;
+        MigrateFirstRunToCompact(config);
         L.Initialize(new LocalizationService(config.PreferredLanguage));
 
         _themeRegistry = new ThemeRegistry();
@@ -113,6 +114,17 @@
         AppLogger.Info("Main window launched");
     }
 
+    // Ensures fresh installs and users who never changed their theme get Compact by default.
+    // Only runs once (guarded by HasSeenThemeHint = false on first run).
+    private static void MigrateFirstRunToCompact(MyMConfig config)
+    {
+        if (!config.HasSeenThemeHint && config.ThemeId == "copypaste.default")
+        {
+            config.ThemeId = "copypaste.compact";
+            ConfigLoader.Save(config);
+        }
+    }
+
     private void InitializeCoreServices()
     {
         _engine = new CopyPasteEngine(svc => new WindowsClipboardListener(svc));
@@ -209,7 +221,7 @@
             const uint MB_OK = 0x00000000;
             const uint MB_ICONINFORMATION = 0x00000040;
 
             _ = MessageBox(hwnd, message, caption, MB_OK | MB_ICONINFORMATION);
         }
         catch (Exception ex)
         {
@@ -229,7 +241,7 @@
             AppLogger.Info("Signaled launcher that app is ready");
         }
         catch (WaitHandleCannotBeOpenedException)
         {
         }
         catch (Exception ex)
         {
@@ -237,7 +249,7 @@
         }
     }
 
     private void OnUnhandledException(object sender, Microsoft.UI.Xaml.UnhandledExceptionEventArgs e)
     {
         AppLogger.Exception(e.Exception, "Unhandled exception");
         e.Handled = true;

CopyPaste.UI/Localization/Languages/en-US.json

@@ -24,7 +24,11 @@
       "selectColors": "Select colors...",
       "selectTypes": "Select types..."
     },
-    "emptyState": "No items in this section"
+    "emptyState": "No items in this section",
+    "firstRun": {
+      "text": "Customize your experience in",
+      "action": "Settings"
+    }
   },
   "config": {
     "window": {

CopyPaste.UI/Localization/Languages/es-CL.json

@@ -24,7 +24,11 @@
       "selectColors": "Seleccionar colores...",
       "selectTypes": "Seleccionar tipos..."
     },
-    "emptyState": "No hay elementos en esta sección"
+    "emptyState": "No hay elementos en esta sección",
+    "firstRun": {
+      "text": "Personaliza tu experiencia en",
+      "action": "Ajustes"
+    }
   },
   "config": {
     "window": {

CopyPaste.UI/Themes/Compact/CompactWindow.xaml

@@ -15,6 +15,7 @@
             <RowDefinition Height="Auto"/>
             <RowDefinition Height="Auto"/>
             <RowDefinition Height="Auto"/>
+            <RowDefinition Height="Auto"/>
             <RowDefinition Height="*"/>
             <RowDefinition Height="Auto"/>
         </Grid.RowDefinitions>
@@ -91,7 +92,7 @@
         </Grid>
 
         <!-- Search/Filter Bar -->
-        <Grid Grid.Row="2" Margin="12,4,12,6">
+        <Grid Grid.Row="3" Margin="12,4,12,6">
             <Grid.ColumnDefinitions>
                 <ColumnDefinition Width="*"/>
                 <ColumnDefinition Width="Auto"/>
@@ -272,8 +273,32 @@
             </Button>
         </Grid>
 
+        <!-- First-run tip (shown once) -->
+        <Grid x:Name="FirstRunBanner"
+              Grid.Row="1"
+              Visibility="Collapsed"
+              Margin="14,2,10,4">
+            <Grid.ColumnDefinitions>
+                <ColumnDefinition Width="*"/>
+                <ColumnDefinition Width="Auto"/>
+            </Grid.ColumnDefinitions>
+            <StackPanel Orientation="Horizontal" Spacing="3" VerticalAlignment="Center">
+                <TextBlock x:Name="FirstRunText" FontSize="11" Opacity="0.45"
+                           VerticalAlignment="Center"
+                           Foreground="{ThemeResource TextFillColorSecondaryBrush}"/>
+                <HyperlinkButton x:Name="FirstRunAction" Padding="2,0" FontSize="11"
+                                 Opacity="0.6" Click="FirstRunAction_Click"
+                                 VerticalAlignment="Center"/>
+            </StackPanel>
+            <Button Grid.Column="1" Width="18" Height="18" Padding="0"
+                    Background="Transparent" BorderThickness="0" CornerRadius="3"
+                    Click="FirstRunBanner_Close" VerticalAlignment="Center">
+                <FontIcon Glyph="&#xE711;" FontSize="7" Opacity="0.3"/>
+            </Button>
+        </Grid>
+
         <!-- Empty State -->
-        <StackPanel Grid.Row="3"
+        <StackPanel Grid.Row="4"
                     HorizontalAlignment="Center"
                     VerticalAlignment="Center"
                     Spacing="8"
@@ -287,7 +312,7 @@
 
         <!-- Clipboard Items List -->
         <ListView x:Name="ClipboardListView"
-                  Grid.Row="3"
+                  Grid.Row="4"
                   ItemsSource="{x:Bind ViewModel.Items, Mode=OneWay}"
                   SelectionMode="Single"
                   IsTabStop="True"
@@ -372,13 +397,15 @@
                                         <ColumnDefinition Width="*"/>
                                         <ColumnDefinition Width="Auto"/>
                                     </Grid.ColumnDefinitions>
-                                    <StackPanel Grid.Column="0" Orientation="Horizontal" Spacing="5">
-                                        <FontIcon Glyph="{x:Bind TypeIcon}" FontSize="10" Opacity="0.4"/>
+                                    <StackPanel Grid.Column="0" Orientation="Horizontal" Spacing="5" VerticalAlignment="Center">
+                                        <FontIcon Glyph="{x:Bind TypeIcon}" FontSize="10" Opacity="0.4" VerticalAlignment="Center"/>
                                         <TextBlock Text="{x:Bind Label, Mode=OneWay}" FontSize="11" Opacity="0.5"
                                                    FontWeight="SemiBold" MaxLines="1" TextTrimming="CharacterEllipsis"
+                                                   VerticalAlignment="Center"
                                                    Visibility="{x:Bind LabelVisibility, Mode=OneWay}"/>
                                         <TextBlock Text="{x:Bind HeaderTitle}" FontSize="11" Opacity="0.4"
-                                                   MaxLines="1" Visibility="{x:Bind DefaultHeaderVisibility, Mode=OneWay}"/>
+                                                   MaxLines="1" VerticalAlignment="Center"
+                                                   Visibility="{x:Bind DefaultHeaderVisibility, Mode=OneWay}"/>
                                     </StackPanel>
                                     <Grid Grid.Column="1" VerticalAlignment="Center">
                                         <!-- Timestamp (visible by default, hidden on hover) -->
@@ -443,17 +470,18 @@
                                 <!-- File warning -->
                                 <StackPanel Grid.Row="2" Orientation="Horizontal" Margin="0,4,0,0"
                                             Visibility="{x:Bind FileWarningVisibility, Mode=OneWay}">
-                                    <FontIcon Glyph="&#xE7BA;" FontSize="10" Foreground="#FFAA00" Margin="0,0,4,0"/>
-                                    <TextBlock Text="{x:Bind FileWarningText}" FontSize="10" Foreground="#FFAA00"/>
+                                    <FontIcon Glyph="&#xE7BA;" FontSize="10" Foreground="#FFAA00" Margin="0,0,4,0" VerticalAlignment="Center"/>
+                                    <TextBlock Text="{x:Bind FileWarningText}" FontSize="10" Foreground="#FFAA00" VerticalAlignment="Center"/>
                                 </StackPanel>
 
                                 <!-- Card footer: source + size + paste count -->
                                 <Grid Grid.Row="3" Margin="0,6,0,0">
                                     <StackPanel Orientation="Horizontal" HorizontalAlignment="Left" Spacing="4"
                                                 Visibility="{x:Bind AppSourceVisibility}">
-                                        <FontIcon Glyph="&#xE7C3;" FontSize="9" Opacity="0.3"/>
+                                        <FontIcon Glyph="&#xE7C3;" FontSize="9" Opacity="0.3" VerticalAlignment="Center"/>
                                         <TextBlock Text="{x:Bind AppSource}" FontSize="10" Opacity="0.35"
-                                                   MaxLines="1" TextTrimming="CharacterEllipsis" MaxWidth="140"/>
+                                                   MaxLines="1" TextTrimming="CharacterEllipsis" MaxWidth="140"
+                                                   VerticalAlignment="Center"/>
                                     </StackPanel>
                                     <StackPanel Orientation="Horizontal" HorizontalAlignment="Right" Spacing="6">
                                         <TextBlock Text="{x:Bind PasteCountDisplay, Mode=OneWay}" FontSize="10" Opacity="0.35"
@@ -474,7 +502,7 @@
         </ListView>
 
         <!-- Bottom Branding Bar -->
-        <Grid Grid.Row="4" Margin="12,4,12,8">
+        <Grid Grid.Row="5" Margin="12,4,12,8">
             <StackPanel Orientation="Horizontal"
                         HorizontalAlignment="Center"
                         Spacing="6"

CopyPaste.UI/Themes/Compact/CompactWindow.xaml.cs

@@ -31,7 +31,7 @@
     internal CompactViewModel ViewModel { get; }
 
     [StructLayout(LayoutKind.Sequential)]
     private struct POINT
     {
         public int X;
         public int Y;
@@ -143,6 +143,12 @@
         FilterModeCategory.Text = L.Get("ui.filterMode.category", "Category");
         FilterModeType.Text = L.Get("ui.filterMode.type", "Type");
 
+        FirstRunText.Text = L.Get("ui.firstRun.text", "Personaliza tu experiencia en");
+        FirstRunAction.Content = L.Get("ui.firstRun.action", "Ajustes");
+
+        if (!_config.HasSeenThemeHint)
+            FirstRunBanner.Visibility = Microsoft.UI.Xaml.Visibility.Visible;
+
         ColorLabelRed.Text = L.Get("clipboard.editDialog.colorRed", "Red");
         ColorLabelGreen.Text = L.Get("clipboard.editDialog.colorGreen", "Green");
         ColorLabelPurple.Text = L.Get("clipboard.editDialog.colorPurple", "Purple");
@@ -258,6 +264,27 @@
         }
     }
 
+    private void FirstRunBanner_Close(object sender, RoutedEventArgs e)
+    {
+        FirstRunBanner.Visibility = Microsoft.UI.Xaml.Visibility.Collapsed;
+        DismissFirstRunHint();
+    }
+
+    private void FirstRunAction_Click(object sender, RoutedEventArgs e)
+    {
+        FirstRunBanner.Visibility = Microsoft.UI.Xaml.Visibility.Collapsed;
+        DismissFirstRunHint();
+        _context.OpenSettings();
+    }
+
+    private static void DismissFirstRunHint()
+    {
+        var cfg = ConfigLoader.Load();
+        if (cfg.HasSeenThemeHint) return;
+        cfg.HasSeenThemeHint = true;
+        ConfigLoader.Save(cfg);
+    }
+
     private void AppWindow_Changed(AppWindow sender, AppWindowChangedEventArgs args)
     {
         if ((args.DidPresenterChange || args.DidVisibilityChange) && !sender.IsVisible)
@@ -278,7 +305,7 @@
     private void TrayMenuSettings_Click(object sender, RoutedEventArgs e) =>
         _context.OpenSettings();
 
     private void Card_PointerEntered(object sender, Microsoft.UI.Xaml.Input.PointerRoutedEventArgs e)
     {
         if (sender is not Border border) return;
         var timestamp = ClipboardWindowHelpers.FindChild<TextBlock>(border, "TimestampText");
@@ -287,7 +314,7 @@
         if (actions != null) actions.Opacity = 1;
     }
 
     private void Card_PointerExited(object sender, Microsoft.UI.Xaml.Input.PointerRoutedEventArgs e)
     {
         if (sender is not Border border) return;
         var timestamp = ClipboardWindowHelpers.FindChild<TextBlock>(border, "TimestampText");
@@ -452,7 +479,7 @@
     {
         if (e.Key is Windows.System.VirtualKey.Enter or Windows.System.VirtualKey.Down)
         {
             if (ClipboardListView.Items.Count > 0)
             {
                 ClipboardListView.SelectedIndex = 0;
 
@@ -470,7 +497,7 @@
         }
     }
 
     private void RootGrid_PreviewKeyDown(object sender, Microsoft.UI.Xaml.Input.KeyRoutedEventArgs e)
     {
         // ESC clears current filter
         if (e.Key == Windows.System.VirtualKey.Escape)

CopyPaste.UI/Themes/Default/DefaultTheme.cs

@@ -11,7 +11,7 @@ namespace CopyPaste.UI.Themes;
 internal sealed class DefaultTheme : ITheme
 {
     public string Id => "copypaste.default";
-    public string Name => "Default";
+    public string Name => "Full";
     public string Version => "1.0.0";
     public string Author => "CopyPaste";
 

Tests/CopyPaste.Core.Tests/MyMConfigTests.cs

@@ -23,10 +23,10 @@ public void DefaultConfig_RunOnStartup_IsTrue()
     }
 
     [Fact]
-    public void DefaultConfig_ThemeId_IsDefault()
+    public void DefaultConfig_ThemeId_IsCompact()
     {
         var config = new MyMConfig();
-        Assert.Equal("copypaste.default", config.ThemeId);
+        Assert.Equal("copypaste.compact", config.ThemeId);
     }
 
     [Fact]