Add "Basis Recommended" one-click pack; suggest it after cloning

Replace the demo "Basis Starter Pack" bundle with "Basis Recommended" — every
curated registry package, added on top of a fresh Basis clone in one press. The
static-site generator refills the bundle from the full package list so it never
drifts behind newly-added packages. After a successful clone the app now offers
to install the whole set (sourced from the loaded catalog, so always current).

Also convert PackageRowTests to [AvaloniaFact] so it can't initialise the
localization singleton before Avalonia's asset loader is ready (which poisoned
later tests), and update the bundle tests for the new bundle id.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: dooly123

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

@@ -290,6 +290,14 @@
       "key": "installs.dialog.nameThisInstall",
       "value": "Name this install"
     },
+    {
+      "key": "installs.dialog.recommendedBody",
+      "value": "Add all {0} recommended Basis packages to this project now? You can manage them anytime on the Packages tab."
+    },
+    {
+      "key": "installs.dialog.recommendedTitle",
+      "value": "Install the Basis Recommended pack?"
+    },
     {
       "key": "installs.empty.body",
       "value": "Use Clone Basis above to pull down BasisVR/Basis, or Add existing to register a clone you already have."
@@ -594,6 +602,10 @@
       "key": "packages.label.project",
       "value": "Project"
     },
+    {
+      "key": "packages.recommended.name",
+      "value": "Basis Recommended"
+    },
     {
       "key": "packages.status.added",
       "value": "Added"
@@ -694,6 +706,10 @@
       "key": "packages.status.pasteGitHub",
       "value": "Paste a GitHub URL or owner/repo."
     },
+    {
+      "key": "packages.status.recommendedEmpty",
+      "value": "No packages available to install — check your connection, then try Refresh on the Packages tab."
+    },
     {
       "key": "packages.status.refusedUnsafeUrl",
       "value": "Refused to add {0}: the install link's git URL uses an unsupported or unsafe transport."

src/BasisPM.App/ViewModels/InstallsViewModel.cs

@@ -305,6 +305,9 @@ private async Task CloneAsync()
                 ? L.Tr("installs.status.requiresUnityNote", install.UnityVersion)
                 : "";
             _shell.SetStatus(L.Tr("installs.status.clonedInto", dest, versionNote), StatusKind.Success);
+
+            // Fresh clone: offer the one-click "Basis Recommended" pack.
+            await OfferRecommendedAsync(install);
         }
         catch (Exception ex)
         {
@@ -313,6 +316,20 @@ private async Task CloneAsync()
         finally { IsCloning = false; }
     }
 
+    /// <summary>After a fresh clone, offers to add the full "Basis Recommended" package set in one press.</summary>
+    private async Task OfferRecommendedAsync(BasisInstall install)
+    {
+        if (!install.HasUnityProject) return;            // no Unity project to add packages to
+        var count = _shell.PackagesVM.RecommendedCount;
+        if (count == 0) return;                          // catalog unavailable (e.g. offline)
+        var yes = await BasisPM.App.Services.Dialogs.ConfirmAsync(
+            L.Tr("installs.dialog.recommendedTitle"),
+            L.Tr("installs.dialog.recommendedBody", count));
+        if (!yes) return;
+        _shell.NavigateTo("packages");
+        await _shell.PackagesVM.InstallRecommendedAsync(install);
+    }
+
     private async Task UpdateCoreAsync(InstallRow? row)
     {
         if (row is null) return;

src/BasisPM.App/ViewModels/PackagesViewModel.cs

@@ -572,6 +572,30 @@ public async Task AddBundleAsync(Bundle bundle, BasisInstall target)
         finally { IsBusy = false; }
     }
 
+    /// <summary>How many packages the "Basis Recommended" pack would add — the whole catalog.</summary>
+    public int RecommendedCount => _catalogService.AllLatest(_catalog).Count();
+
+    /// <summary>Installs the full "Basis Recommended" set (every catalog package) into the target project.</summary>
+    public async Task InstallRecommendedAsync(BasisInstall target)
+    {
+        var packages = _catalogService.AllLatest(_catalog)
+            .Where(v => !string.IsNullOrWhiteSpace(v.Url))
+            .Select(v => new BundlePackage { Id = v.Name, Name = v.DisplayName, GitUrl = v.Url })
+            .ToList();
+        if (packages.Count == 0)
+        {
+            _shell.SetStatus(L.Tr("packages.status.recommendedEmpty"), StatusKind.Info);
+            return;
+        }
+        var bundle = new Bundle
+        {
+            Id = "basis-recommended",
+            Name = L.Tr("packages.recommended.name"),
+            Packages = packages,
+        };
+        await AddBundleAsync(bundle, target);
+    }
+
     private static string Slugify(string s)
     {
         var slug = new string(s.ToLowerInvariant().Select(c => char.IsLetterOrDigit(c) ? c : '-').ToArray());

src/BasisPM.Server/Program.cs

@@ -154,9 +154,17 @@ static async Task GenerateStaticSiteAsync(string outDir)
     File.WriteAllText(Path.Combine(outDir, "packages.json"), JsonSerializer.Serialize(packages, opts));
     File.WriteAllText(Path.Combine(outDir, "catalog.json"), JsonSerializer.Serialize(PackageStore.BuildCatalog(packages), opts));
 
-    // Curated bundles — copied through as-is for the website's Bundles view + install-back.
+    // Curated bundles for the website's Bundles view + install-back.
     var bundleSeed = ResolveUp(baseDir, Path.Combine("seed", "bundles.json"));
     var bundles = BundleStore.LoadSeed(bundleSeed);
+    // "Basis Recommended" always holds every registry package — refill it from the current list so
+    // it can never drift behind newly-added packages.
+    var recommended = bundles.FirstOrDefault(b => b.Id == "basis-recommended");
+    if (recommended is not null)
+        recommended.Packages = packages
+            .Where(p => !string.IsNullOrWhiteSpace(p.GitUrl))
+            .Select(p => new BundlePackage { Id = p.Id, Name = p.Name, GitUrl = p.GitUrl })
+            .ToList();
     File.WriteAllText(Path.Combine(outDir, "bundles.json"), JsonSerializer.Serialize(bundles, opts));
 
     File.Copy(indexPath, Path.Combine(outDir, "index.html"), overwrite: true);

src/BasisPM.Server/seed/bundles.json

@@ -1,20 +1,109 @@
 [
   {
-    "id": "basis-starter",
-    "name": "Basis Starter Pack",
-    "description": "A minimal starting point — Basis plus the community Pool Table world asset. A demo bundle.",
+    "id": "basis-recommended",
+    "name": "Basis Recommended",
+    "description": "Every curated Basis package — the full recommended set, added on top of a fresh Basis clone in one click.",
     "author": "BasisVR",
     "authorUrl": "https://github.com/BasisVR",
     "basisBranch": "main",
     "unity": "6000.0",
-    "icon": "🧩",
-    "tags": [ "starter", "example", "worlds" ],
+    "icon": "⭐",
+    "tags": [
+      "recommended",
+      "everything",
+      "all"
+    ],
     "packages": [
       {
         "id": "com.basis.pooltable",
         "name": "Basis Ported Pooltable",
-        "gitUrl": "https://github.com/dooly123/MS-BASISSA-Billiards.git"
+        "gitUrl": "https://github.com/BasisVR/BasisPoolTable.git"
+      },
+      {
+        "id": "com.basis.addon.snapcontrols",
+        "name": "Basis Snap Controls",
+        "gitUrl": "https://github.com/BasisVR/BasisSnapControls.git"
+      },
+      {
+        "id": "com.basis.developer.recorder",
+        "name": "Basis Avatar Recorder",
+        "gitUrl": "https://github.com/BasisVR/BasisAvatarRecorder.git"
+      },
+      {
+        "id": "com.basis.developer.exceptions",
+        "name": "Basis Exception Reporting",
+        "gitUrl": "https://github.com/BasisVR/BasisExceptionReporting.git"
+      },
+      {
+        "id": "com.basis.provider.servers",
+        "name": "Basis Servers Panel",
+        "gitUrl": "https://github.com/BasisVR/BasisServersProvider.git"
+      },
+      {
+        "id": "com.basis.imagepickup",
+        "name": "Basis Image Pickup",
+        "gitUrl": "https://github.com/BasisVR/BasisImagePickup.git"
+      },
+      {
+        "id": "com.basis.vehicles",
+        "name": "Basis Vehicles",
+        "gitUrl": "https://github.com/BasisVR/BasisVehicles.git"
+      },
+      {
+        "id": "com.basis.examples",
+        "name": "Basis Examples",
+        "gitUrl": "https://github.com/BasisVR/BasisExamples.git"
+      },
+      {
+        "id": "com.basis.mediaplayer",
+        "name": "Basis Media Player",
+        "gitUrl": "https://github.com/BasisVR/BasisMediaPlayer.git"
+      },
+      {
+        "id": "com.basis.integration.ytdlp",
+        "name": "Basis yt-dlp Integration",
+        "gitUrl": "https://github.com/BasisVR/BasisYtDlpIntegration.git"
+      },
+      {
+        "id": "com.basis.integration.audiolink",
+        "name": "Basis AudioLink Integration",
+        "gitUrl": "https://github.com/BasisVR/BasisAudioLinkIntegration.git"
+      },
+      {
+        "id": "com.basis.openxr",
+        "name": "Basis OpenXR Integration",
+        "gitUrl": "https://github.com/BasisVR/BasisOpenXR.git"
+      },
+      {
+        "id": "com.basis.visualtrackers",
+        "name": "Basis Visual Trackers",
+        "gitUrl": "https://github.com/BasisVR/BasisVisualTrackers.git"
+      },
+      {
+        "id": "com.basis.openvr",
+        "name": "Basis OpenVR Integration",
+        "gitUrl": "https://github.com/BasisVR/BasisOpenVR.git"
+      },
+      {
+        "id": "com.steam.steamvr",
+        "name": "SteamVR (for Basis)",
+        "gitUrl": "https://github.com/BasisVR/BasisSteamVR.git"
+      },
+      {
+        "id": "com.valvesoftware.unity.openvr",
+        "name": "OpenVR XR Plugin",
+        "gitUrl": "https://github.com/BasisVR/BasisOpenVRPlugin.git"
+      },
+      {
+        "id": "com.cnlohr.cilbox",
+        "name": "Cilbox",
+        "gitUrl": "https://github.com/BasisVR/BasisCilbox.git"
+      },
+      {
+        "id": "com.cqf.urpvolumetricfog",
+        "name": "URP Volumetric Fog",
+        "gitUrl": "https://github.com/BasisVR/BasisVolumetricFog.git"
       }
     ]
   }
-]
+]

tests/BasisPM.App.Tests/DeepLinkTests.cs

@@ -54,8 +54,8 @@ public void TryParseInstall_rejects_a_non_deeplink()
     [Fact]
     public void TryParseBundle_extracts_the_id()
     {
-        Assert.True(DeepLink.TryParseBundle("basispm://bundle?id=basis-starter", out var id));
-        Assert.Equal("basis-starter", id);
+        Assert.True(DeepLink.TryParseBundle("basispm://bundle?id=basis-recommended", out var id));
+        Assert.Equal("basis-recommended", id);
     }
 
     [Fact]

tests/BasisPM.App.Tests/PackageRowTests.cs

@@ -1,3 +1,4 @@
+using Avalonia.Headless.XUnit;
 using BasisPM.App.ViewModels;
 using BasisPM.Core.Models;
 using Xunit;
@@ -20,23 +21,23 @@ private static CatalogPackageVersion Entry(
             Author = author is null ? null : new CatalogAuthor { Name = author },
         };
 
-    [Fact]
+    [AvaloniaFact]
     public void Not_installed_row_shows_install()
     {
         var row = new PackageRow(Entry(), InstalledVersion: null);
         Assert.False(row.IsInstalled);
         Assert.Equal("Install", row.ButtonLabel);
     }
 
-    [Fact]
+    [AvaloniaFact]
     public void Installed_row_shows_update()
     {
         var row = new PackageRow(Entry(), InstalledVersion: "1.0.0");
         Assert.True(row.IsInstalled);
         Assert.Equal("Update", row.ButtonLabel);
     }
 
-    [Fact]
+    [AvaloniaFact]
     public void Passes_through_catalog_fields()
     {
         var row = new PackageRow(Entry(display: "Basis SDK", version: "2.1.0"), null);
@@ -46,7 +47,7 @@ public void Passes_through_catalog_fields()
         Assert.Equal("A package.", row.Description);
     }
 
-    [Fact]
+    [AvaloniaFact]
     public void Author_and_unity_presence_flags()
     {
         var withBoth = new PackageRow(Entry(unity: "6000.0", author: "BasisVR"), null);
@@ -60,7 +61,7 @@ public void Author_and_unity_presence_flags()
         Assert.False(withNeither.HasUnity);
     }
 
-    [Fact]
+    [AvaloniaFact]
     public void License_presence_flag_and_passthrough()
     {
         var withLicense = new PackageRow(Entry(license: "MIT AND Unlicense"), null);
@@ -71,7 +72,7 @@ public void License_presence_flag_and_passthrough()
         Assert.False(noLicense.HasLicense);
     }
 
-    [Theory]
+    [AvaloniaTheory]
     [InlineData("Basis SDK", "B")]
     [InlineData("  spaced name", "S")]
     [InlineData("", "?")]
@@ -80,7 +81,7 @@ public void Initial_is_the_first_letter_or_question_mark(string display, string
         Assert.Equal(expected, new PackageRow(Entry(display: display), null).Initial);
     }
 
-    [Theory]
+    [AvaloniaTheory]
     [InlineData("com.unity.2d.sprite", "Unity")]
     [InlineData("com.basis.sdk", "Basis")]
     [InlineData("foo", "Foo")]
@@ -90,7 +91,7 @@ public void Owner_is_derived_from_the_package_id(string name, string expectedOwn
         Assert.Equal(expectedOwner, new PackageRow(Entry(name: name), null).Owner);
     }
 
-    [Fact]
+    [AvaloniaFact]
     public void InstalledPackageRow_exposes_its_fields()
     {
         var row = new InstalledPackageRow("com.x", "X Package", "https://github.com/x/x.git", IsFromGit: true);

tests/BasisPM.Server.Tests/ApiGetTests.cs

@@ -10,7 +10,7 @@ namespace BasisPM.Server.Tests;
 public sealed class ApiGetTests : IClassFixture<DisabledSubmissionsFactory>
 {
     private const string SeedPackageId = "com.basis.pooltable";
-    private const string SeedBundleId = "basis-starter";
+    private const string SeedBundleId = "basis-recommended";
     private readonly HttpClient _client;
 
     public ApiGetTests(DisabledSubmissionsFactory factory) => _client = factory.CreateClient();