Cross-platform hardening (Platform/DiskSpace/services) + project-card layout & UI polish

Author: dooly123

src/BasisPM.App/Localization/Languages/en.json

@@ -566,6 +566,10 @@
       "key": "packages.button.gridView",
       "value": "Grid view"
     },
+    {
+      "key": "packages.button.installBundleFile",
+      "value": "Install bundle from file…"
+    },
     {
       "key": "packages.button.install",
       "value": "Install"
@@ -670,6 +674,14 @@
       "key": "packages.label.project",
       "value": "Project"
     },
+    {
+      "key": "packages.picker.openBundle",
+      "value": "Open bundle file"
+    },
+    {
+      "key": "packages.picker.saveBundle",
+      "value": "Save bundle"
+    },
     {
       "key": "packages.recommended.name",
       "value": "Basis Recommended"
@@ -690,10 +702,22 @@
       "key": "packages.status.addedFromGitHub",
       "value": "{0} {1}{2} from GitHub."
     },
+    {
+      "key": "packages.status.bundleFileEmpty",
+      "value": "That bundle file has no packages."
+    },
+    {
+      "key": "packages.status.bundleFileInvalid",
+      "value": "That file isn’t a valid bundle: {0}"
+    },
     {
       "key": "packages.status.bundleInstallFailed",
       "value": "Bundle install failed: {0}"
     },
+    {
+      "key": "packages.status.bundleSaved",
+      "value": "Saved bundle “{0}” ({1} package(s)) → {2}"
+    },
     {
       "key": "packages.status.chooseProject",
       "value": "Choose a project first."
@@ -1672,7 +1696,7 @@
     },
     {
       "key": "dialog.createBundle.create",
-      "value": "Create submission"
+      "value": "Submit"
     },
     {
       "key": "dialog.createBundle.descriptionLabel",
@@ -1692,7 +1716,7 @@
     },
     {
       "key": "dialog.createBundle.intro",
-      "value": "Share your Basis + packages as an installable bundle. It opens a GitHub issue to submit."
+      "value": "Bundle your Basis + packages. Save it to a file to keep or share locally, or submit it to the public registry."
     },
     {
       "key": "dialog.createBundle.nameLabel",
@@ -1702,6 +1726,10 @@
       "key": "dialog.createBundle.packagesLabel",
       "value": "Packages to include"
     },
+    {
+      "key": "dialog.createBundle.saveLocal",
+      "value": "Save to file"
+    },
     {
       "key": "dialog.createBundle.title",
       "value": "Create bundle"

src/BasisPM.App/Services/DeepLink.cs

@@ -1,5 +1,4 @@
 using System.Diagnostics;
-using System.Runtime.InteropServices;
 
 namespace BasisPM.App.Services;
 
@@ -61,16 +60,25 @@ private static bool TryParse(string? uri, string expectedHost, out Func<string,
     }
 
     /// <summary>
-    /// Registers the <c>basispm://</c> scheme so the OS routes links to this app.
-    /// Only for installed (Velopack) Windows builds — dev runs are tested by launching
-    /// the exe with the URI argument directly.
+    /// Registers the <c>basispm://</c> scheme so the OS routes links to this app. Only for installed
+    /// (Velopack) builds — dev runs are tested by launching the exe with the URI argument directly.
+    /// Windows writes the HKCU class; Linux writes an XDG <c>.desktop</c> handler; macOS declares the
+    /// scheme via <c>CFBundleURLTypes</c> in the app bundle's Info.plist at packaging time (LaunchServices
+    /// reads it on install), so there is nothing to register at runtime there.
     /// </summary>
     public static void RegisterProtocolIfPackaged(bool isPackaged)
     {
-        if (!isPackaged || !RuntimeInformation.IsOSPlatform(OSPlatform.Windows)) return;
+        if (!isPackaged) return;
         var exe = Environment.ProcessPath;
         if (string.IsNullOrEmpty(exe)) return;
 
+        if (OperatingSystem.IsWindows()) RegisterWindows(exe);
+        else if (OperatingSystem.IsLinux()) RegisterLinux(exe);
+        // macOS handled at packaging time (Info.plist), see summary.
+    }
+
+    private static void RegisterWindows(string exe)
+    {
         var root = $@"HKCU\Software\Classes\{Scheme}";
         try
         {
@@ -90,4 +98,44 @@ private static void Reg(string key, params string[] rest)
         psi.ArgumentList.Add("/f");
         Process.Start(psi)?.WaitForExit(3000);
     }
+
+    /// <summary>The XDG desktop-entry filename that owns the scheme (also the id passed to xdg-mime).</summary>
+    public const string LinuxDesktopFile = "basispm-url-handler.desktop";
+
+    /// <summary>The <c>.desktop</c> file body registering this app as the handler for <c>basispm://</c>. Pure, so it's testable.</summary>
+    public static string LinuxDesktopEntry(string exe) =>
+        "[Desktop Entry]\n" +
+        "Type=Application\n" +
+        "Name=Basis Package Manager\n" +
+        $"Exec=\"{exe}\" %u\n" +
+        "NoDisplay=true\n" +
+        "StartupNotify=false\n" +
+        "Terminal=false\n" +
+        $"MimeType=x-scheme-handler/{Scheme};\n";
+
+    private static void RegisterLinux(string exe)
+    {
+        try
+        {
+            var appsDir = Path.Combine(
+                Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "applications");
+            Directory.CreateDirectory(appsDir);
+            File.WriteAllText(Path.Combine(appsDir, LinuxDesktopFile), LinuxDesktopEntry(exe));
+            // Make this desktop entry the default handler for the scheme, then refresh the DB (both best-effort).
+            RunQuiet("xdg-mime", "default", LinuxDesktopFile, $"x-scheme-handler/{Scheme}");
+            RunQuiet("update-desktop-database", appsDir);
+        }
+        catch { /* best effort — deep links simply won't route until next successful run */ }
+    }
+
+    private static void RunQuiet(string exe, params string[] args)
+    {
+        try
+        {
+            var psi = new ProcessStartInfo(exe) { UseShellExecute = false, CreateNoWindow = true };
+            foreach (var a in args) psi.ArgumentList.Add(a);
+            Process.Start(psi)?.WaitForExit(3000);
+        }
+        catch { }
+    }
 }

src/BasisPM.App/Services/Dialogs.cs

@@ -1,5 +1,7 @@
 using Avalonia.Controls;
 using Avalonia.Controls.ApplicationLifetimes;
+using Avalonia.Platform.Storage;
+using BasisPM.App.Localization;
 using BasisPM.App.Views;
 using BasisPM.Core.Models;
 using BasisPM.Core.Services;
@@ -12,6 +14,12 @@ public static class Dialogs
     private static Window? Owner =>
         Avalonia.Application.Current?.ApplicationLifetime is IClassicDesktopStyleApplicationLifetime d ? d.MainWindow : null;
 
+    private static FilePickerFileType BundleFileType => new("Basis bundle")
+    {
+        Patterns = new[] { "*.json" },
+        MimeTypes = new[] { "application/json" },
+    };
+
     /// <summary>Asks for a display name; returns the trimmed value, or null if cancelled/empty.</summary>
     public static async Task<string?> PromptAliasAsync(string title, string path, string suggested)
     {
@@ -44,6 +52,38 @@ public static async Task<bool> ConfirmAsync(string title, string message)
         return await new CreateBundleWindow(suggestedName, basisLine, candidates).ShowDialog<BundleDraft?>(owner);
     }
 
+    /// <summary>Prompts for a save location and writes the bundle JSON there; returns the saved path, or null if cancelled.</summary>
+    public static async Task<string?> SaveBundleFileAsync(string suggestedFileName, string json)
+    {
+        var owner = Owner;
+        if (owner is null) return null;
+        var file = await owner.StorageProvider.SaveFilePickerAsync(new FilePickerSaveOptions
+        {
+            Title = L.Tr("packages.picker.saveBundle"),
+            SuggestedFileName = suggestedFileName,
+            DefaultExtension = "json",
+            FileTypeChoices = new[] { BundleFileType },
+        });
+        var path = file?.TryGetLocalPath();
+        if (string.IsNullOrEmpty(path)) return null;
+        await File.WriteAllTextAsync(path, json);
+        return path;
+    }
+
+    /// <summary>Prompts the user to pick a local bundle file; returns its path, or null if cancelled.</summary>
+    public static async Task<string?> OpenBundleFileAsync()
+    {
+        var owner = Owner;
+        if (owner is null) return null;
+        var files = await owner.StorageProvider.OpenFilePickerAsync(new FilePickerOpenOptions
+        {
+            Title = L.Tr("packages.picker.openBundle"),
+            AllowMultiple = false,
+            FileTypeFilter = new[] { BundleFileType },
+        });
+        return files?.FirstOrDefault()?.TryGetLocalPath();
+    }
+
     /// <summary>Collects pull-request details for a mounted package; returns the request, or null if cancelled.</summary>
     public static async Task<PrRequest?> SubmitPrAsync(string packageId)
     {

src/BasisPM.App/Styles/BasisTheme.axaml

@@ -63,6 +63,12 @@
 
             <SolidColorBrush x:Key="BasisAccentBrush" Color="{StaticResource BasisBrand}"/>
 
+            <!-- Monospace stack for code / logs / git URLs / diffs. Avalonia doesn't resolve the CSS
+                 generic "monospace", so real family names for all three desktop OSes are listed: Windows
+                 (Cascadia/Consolas), macOS (Menlo/Monaco), Linux (DejaVu/Liberation/Ubuntu/Noto). Without
+                 this, those fields fall back to the proportional UI font on Linux. -->
+            <FontFamily x:Key="MonoFontFamily">Cascadia Mono, Cascadia Code, Consolas, Menlo, Monaco, DejaVu Sans Mono, Liberation Mono, Ubuntu Mono, Noto Sans Mono, Courier New, monospace</FontFamily>
+
             <LinearGradientBrush x:Key="BasisAnimatedGradient" StartPoint="100%,0%" EndPoint="0%,100%">
                 <GradientStop Offset="0" Color="#EF1237"/>
                 <GradientStop Offset="0.33" Color="#9333EA"/>

src/BasisPM.App/ViewModels/PackagesViewModel.cs

@@ -95,6 +95,7 @@ public PackageRow? SelectedPackage
     public RelayCommand RefreshCommand { get; }
     public RelayCommand AddFromGitHubCommand { get; }
     public RelayCommand CreateBundleCommand { get; }
+    public RelayCommand InstallBundleFromFileCommand { get; }
     public RelayCommand<CatalogPackageVersion> ChooseVersionCommand { get; }
     public RelayCommand ToggleLayoutCommand { get; }
     public RelayCommand<string> OpenLinkCommand { get; }
@@ -114,6 +115,7 @@ public PackagesViewModel(UserSettingsService settingsService, CatalogService cat
         RefreshCommand = new RelayCommand(RefreshAsync);
         AddFromGitHubCommand = new RelayCommand(AddFromGitHubAsync);
         CreateBundleCommand = new RelayCommand(CreateBundleAsync);
+        InstallBundleFromFileCommand = new RelayCommand(InstallBundleFromFileAsync);
         ChooseVersionCommand = new RelayCommand<CatalogPackageVersion>(ChooseVersionAsync);
         ToggleLayoutCommand = new RelayCommand(() => IsGridView = !IsGridView);
         OpenLinkCommand = new RelayCommand<string>(url => { if (!string.IsNullOrWhiteSpace(url)) ExternalLink.Open(url!); });
@@ -594,6 +596,16 @@ private async Task CreateBundleAsync()
             WriteIndented = true,
             DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
         });
+
+        // Local: write the bundle JSON to a file the user keeps — no submission.
+        if (draft.Destination == BundleDestination.SaveToFile)
+        {
+            var savedPath = await Dialogs.SaveBundleFileAsync(bundle.Id, json);
+            if (savedPath is not null)
+                _shell.SetStatus(L.Tr("packages.status.bundleSaved", draft.Name, draft.Packages.Count, savedPath), StatusKind.Success);
+            return;
+        }
+
         var body = "### Bundle submission\n\nAdd this entry to `src/BasisPM.Server/seed/bundles.json`:\n\n```json\n" + json + "\n```\n";
         var url = "https://github.com/BasisVR/BasisPackageManager/issues/new?labels=bundle-submission"
                 + "&title=" + Uri.EscapeDataString("Add bundle: " + draft.Name)
@@ -602,6 +614,37 @@ private async Task CreateBundleAsync()
         _shell.SetStatus(L.Tr("packages.status.openingIssue", draft.Name, draft.Packages.Count), StatusKind.Success);
     }
 
+    /// <summary>Reads a local bundle file (as saved by "Save to file") and installs its packages into a chosen project.</summary>
+    private async Task InstallBundleFromFileAsync()
+    {
+        var path = await Dialogs.OpenBundleFileAsync();
+        if (string.IsNullOrEmpty(path)) return;
+
+        Bundle? bundle;
+        try
+        {
+            var json = await File.ReadAllTextAsync(path);
+            bundle = JsonSerializer.Deserialize<Bundle>(json, new JsonSerializerOptions { PropertyNameCaseInsensitive = true });
+        }
+        catch (Exception ex)
+        {
+            _shell.SetStatus(L.Tr("packages.status.bundleFileInvalid", ex.Message), StatusKind.Error);
+            return;
+        }
+
+        if (bundle is null || bundle.Packages.Count == 0)
+        {
+            _shell.SetStatus(L.Tr("packages.status.bundleFileEmpty"), StatusKind.Error);
+            return;
+        }
+
+        var target = await _shell.ChooseInstallTargetAsync(L.Tr("shell.bundle.pickerLabel", bundle.Name, bundle.Packages.Count));
+        if (target is null) return;
+
+        _shell.SetActiveInstall(target);
+        await AddBundleAsync(bundle, target);
+    }
+
     /// <summary>Adds every package in a bundle to the target project's manifest (used by the bundle deep link).</summary>
     public async Task AddBundleAsync(Bundle bundle, BasisInstall target)
     {

src/BasisPM.App/Views/AnnouncementsView.axaml

@@ -14,9 +14,9 @@
                 <Grid ColumnDefinitions="*,Auto" VerticalAlignment="Center">
                     <StackPanel Grid.Column="0" Spacing="6">
                         <TextBlock Text="{loc:Tr announcements.hero.tagline}" Classes="tagline"/>
-                        <TextBlock Text="{loc:Tr announcements.hero.title}" Classes="h1"/>
+                        <TextBlock Text="{loc:Tr announcements.hero.title}" Classes="h1" TextWrapping="Wrap"/>
                         <TextBlock Text="{loc:Tr announcements.hero.subtitle}"
-                                   Classes="muted" FontSize="14"/>
+                                   Classes="muted" FontSize="14" TextWrapping="Wrap"/>
                     </StackPanel>
                     <Button Grid.Column="1" Classes="iconBtn" VerticalAlignment="Center"
                             Command="{Binding RefreshCommand}" ToolTip.Tip="{loc:Tr announcements.button.refresh}">
@@ -49,7 +49,7 @@
                                     <TextBlock Text="{Binding DateDisplay}" Classes="dim" FontSize="12"
                                                VerticalAlignment="Center" IsVisible="{Binding HasDate}"/>
                                 </StackPanel>
-                                <TextBlock Text="{Binding Title}" Classes="h3" FontSize="17"/>
+                                <TextBlock Text="{Binding Title}" Classes="h3" FontSize="17" TextWrapping="Wrap"/>
                                 <TextBlock Text="{Binding Body}" Classes="muted" FontSize="13" TextWrapping="Wrap"/>
                                 <Button Content="{Binding LinkText}" HorizontalAlignment="Left"
                                         IsVisible="{Binding HasLink}"

src/BasisPM.App/Views/ChangesView.axaml

@@ -15,9 +15,9 @@
             <Grid ColumnDefinitions="*,Auto" VerticalAlignment="Center">
                 <StackPanel Grid.Column="0" Spacing="6">
                     <TextBlock Text="{loc:Tr changes.hero.tagline}" Classes="tagline"/>
-                    <TextBlock Text="{Binding InstallName}" Classes="h1"/>
+                    <TextBlock Text="{Binding InstallName}" Classes="h1" TextWrapping="Wrap"/>
                     <TextBlock Text="{loc:Tr changes.hero.subtitle}"
-                               Classes="muted" FontSize="14"/>
+                               Classes="muted" FontSize="14" TextWrapping="Wrap"/>
                 </StackPanel>
                 <Button Grid.Column="1" Classes="iconBtn" Command="{Binding RefreshCommand}" ToolTip.Tip="{loc:Tr changes.button.refresh}">
                     <PathIcon Width="16" Height="16" Data="{StaticResource IconRefresh}"/>
@@ -63,7 +63,7 @@
                     <ScrollViewer Grid.Row="1" Padding="16,12"
                                   HorizontalScrollBarVisibility="Auto" VerticalScrollBarVisibility="Auto">
                         <SelectableTextBlock Text="{Binding DiffText}"
-                                             FontFamily="Cascadia Mono, Consolas, Menlo, monospace"
+                                             FontFamily="{StaticResource MonoFontFamily}"
                                              FontSize="12" Foreground="{StaticResource BasisTextMutedBrush}"/>
                     </ScrollViewer>
                 </Grid>
@@ -74,7 +74,8 @@
             <StackPanel Spacing="10" HorizontalAlignment="Center" VerticalAlignment="Center" Margin="0,60">
                 <TextBlock Text="{loc:Tr changes.empty.title}" Classes="h3" HorizontalAlignment="Center"/>
                 <TextBlock Text="{loc:Tr changes.empty.description}"
-                           Classes="muted" HorizontalAlignment="Center"/>
+                           Classes="muted" HorizontalAlignment="Center" TextAlignment="Center"
+                           MaxWidth="480" TextWrapping="Wrap"/>
             </StackPanel>
         </Border>
     </Grid>