From e63b1f709db5479e26d5d89a38373e2253a05e04 Mon Sep 17 00:00:00 2001
From: Norton Andreev <norton@nortonandreev.com>
Date: Fri, 23 Oct 2026 16:17:55 +0300
Subject: [PATCH 1/2] app: Show why the local edition is unavailable inside its
 card

The reason was a separate box between the two edition cards, with its own radius, so it read as a third option. It is now the card's footer under a divider, and the card's head fades while the reason stays legible.
---
 .../Views/Onboarding/OnboardingPaneView.axaml | 30 ++++++++++-------
 .../Views/Onboarding/OnboardingStyles.axaml   |  8 +++++
 .../EditionStepViewModelTests.cs              | 32 +++++++++++++++++++
 3 files changed, 59 insertions(+), 11 deletions(-)

diff --git a/src/Capacitor.App/Views/Onboarding/OnboardingPaneView.axaml b/src/Capacitor.App/Views/Onboarding/OnboardingPaneView.axaml
index c2d7f2353c..76c9040a78 100644
--- a/src/Capacitor.App/Views/Onboarding/OnboardingPaneView.axaml
+++ b/src/Capacitor.App/Views/Onboarding/OnboardingPaneView.axaml
@@ -15,18 +15,26 @@
                     <TextBlock x:Name="EditionNoticeText" Classes="onboardingBody" Text="{Binding Notice}" />
                 </Border>
                 <Button x:Name="LocalEditionButton" Classes="onboardingEditionCard" Command="{Binding ChooseLocalCommand}"
-                        AutomationProperties.Name="{x:Static vm:EditionStepViewModel.LocalTitle}">
-                    <Grid ColumnDefinitions="Auto,*" RowDefinitions="Auto,Auto" ColumnSpacing="14" RowSpacing="4">
-                        <app:AppIcon Kind="Laptop" Size="20" />
-                        <TextBlock Grid.Column="1" Classes="onboardingLabel" VerticalAlignment="Center"
-                                   Text="{x:Static vm:EditionStepViewModel.LocalTitle}" />
-                        <TextBlock Grid.Row="1" Grid.Column="1" Classes="onboardingDetail" Text="{x:Static vm:EditionStepViewModel.LocalDetail}" />
-                    </Grid>
+                        AutomationProperties.Name="{x:Static vm:EditionStepViewModel.LocalTitle}"
+                        AutomationProperties.HelpText="{Binding LocalUnavailableReason}">
+                    <StackPanel>
+                        <Grid Classes="onboardingEditionHead" ColumnDefinitions="Auto,*" RowDefinitions="Auto,Auto" ColumnSpacing="14" RowSpacing="4">
+                            <app:AppIcon Kind="Laptop" Size="20" />
+                            <TextBlock Grid.Column="1" Classes="onboardingLabel" VerticalAlignment="Center"
+                                       Text="{x:Static vm:EditionStepViewModel.LocalTitle}" />
+                            <TextBlock Grid.Row="1" Grid.Column="1" Classes="onboardingDetail" Text="{x:Static vm:EditionStepViewModel.LocalDetail}" />
+                        </Grid>
+                        <StackPanel Classes="onboardingEditionFooter" IsVisible="{Binding LocalUnavailableVisible}">
+                            <Border Classes="onboardingDivider" />
+                            <Grid ColumnDefinitions="20,*" ColumnSpacing="14">
+                                <app:AppIcon Kind="Info" Size="14" HorizontalAlignment="Center" VerticalAlignment="Top"
+                                             Margin="0,2,0,0" Foreground="{StaticResource OnboardingDimBrush}" />
+                                <TextBlock Grid.Column="1" x:Name="LocalUnavailableText" Classes="onboardingNote"
+                                           Foreground="{StaticResource OnboardingMutedBrush}" Text="{Binding LocalUnavailableReason}" />
+                            </Grid>
+                        </StackPanel>
+                    </StackPanel>
                 </Button>
-                <Border Classes="onboardingCallout" IsVisible="{Binding LocalUnavailableVisible}">
-                    <TextBlock x:Name="LocalUnavailableText" Classes="onboardingBody"
-                               Text="{Binding LocalUnavailableReason}" />
-                </Border>
 
                 <Button x:Name="CloudEditionButton" Classes="onboardingEditionCard" Command="{Binding ChooseCloudCommand}"
                         AutomationProperties.Name="{x:Static vm:EditionStepViewModel.CloudTitle}">
diff --git a/src/Capacitor.App/Views/Onboarding/OnboardingStyles.axaml b/src/Capacitor.App/Views/Onboarding/OnboardingStyles.axaml
index db3c20af12..a650680d5f 100644
--- a/src/Capacitor.App/Views/Onboarding/OnboardingStyles.axaml
+++ b/src/Capacitor.App/Views/Onboarding/OnboardingStyles.axaml
@@ -250,6 +250,14 @@
         <Setter Property="BorderBrush" Value="{StaticResource OnboardingAccentBrush}" />
         <Setter Property="Foreground" Value="{StaticResource OnboardingTextBrush}" />
     </Style>
+    <!-- An edition this machine cannot take: the head fades, the footer saying why stays legible. -->
+    <Style Selector="Button.onboardingEditionCard:disabled Grid.onboardingEditionHead">
+        <Setter Property="Opacity" Value="0.5" />
+    </Style>
+    <Style Selector="StackPanel.onboardingEditionFooter">
+        <Setter Property="Spacing" Value="14" />
+        <Setter Property="Margin" Value="0,16,0,0" />
+    </Style>
     <Style Selector="Button.onboardingCompact">
         <Setter Property="Padding" Value="14,9" />
         <Setter Property="FontFamily" Value="{StaticResource OnboardingMonoFont}" />
diff --git a/test/Capacitor.App.Tests.Unit/EditionStepViewModelTests.cs b/test/Capacitor.App.Tests.Unit/EditionStepViewModelTests.cs
index 912559f3b1..20b5850815 100644
--- a/test/Capacitor.App.Tests.Unit/EditionStepViewModelTests.cs
+++ b/test/Capacitor.App.Tests.Unit/EditionStepViewModelTests.cs
@@ -185,6 +185,38 @@ public async Task The_pane_shows_the_cards_in_place_of_next_and_the_cloud_card_r
         await Assert.That(after).IsEqualTo(WizardStepId.SignIn);
     }
 
+    /// The reason is the card's own footer, not a sibling between the two cards, and the card
+    /// carries it as help text while it refuses the choice.
+    [Test]
+    [NotInParallel("AvaloniaSession")]
+    public async Task An_unavailable_local_card_says_why_in_its_own_footer() {
+        var (inCard, footerShown, enabled, help) = await AvaloniaSession.DispatchAsync(async () => {
+            var edition = new EditionStepViewModel(
+                CliTelemetry.Disabled(TimeProvider.System).Funnel, () => EditionStepViewModel.UnsupportedPlatform);
+            var vm = new OnboardingViewModel([edition, new FakeWizardStep(WizardStepId.SignIn)]);
+            await vm.PendingEnterForTesting;
+
+            var window = new MainWindow { Onboarding = vm };
+            window.Show();
+            Dispatcher.UIThread.RunJobs();
+
+            var local = window.GetVisualDescendants().OfType<Button>().First(c => c.Name == "LocalEditionButton");
+            var reason = window.GetVisualDescendants().OfType<TextBlock>().First(c => c.Name == "LocalUnavailableText");
+            var result = (reason.GetVisualAncestors().Contains(local), reason.IsEffectivelyVisible, local.IsEffectivelyEnabled,
+                Avalonia.Automation.AutomationProperties.GetHelpText(local));
+
+            window.Close();
+            Dispatcher.UIThread.RunJobs();
+
+            return result;
+        });
+
+        await Assert.That(inCard).IsTrue();
+        await Assert.That(footerShown).IsTrue();
+        await Assert.That(enabled).IsFalse();
+        await Assert.That(help).IsEqualTo(EditionStepViewModel.UnsupportedPlatform);
+    }
+
     [Test]
     [NotInParallel("AvaloniaSession")]
     public async Task A_notice_stays_until_the_next_choice() {

From e122d29ee294880cb031faa9e6ea8a7057f89d1f Mon Sep 17 00:00:00 2001
From: Norton Andreev <norton@nortonandreev.com>
Date: Fri, 23 Oct 2026 17:02:06 +0300
Subject: [PATCH 2/2] app: Pin the unavailable reason at full strength inside
 the disabled card

---
 .../EditionStepViewModelTests.cs                   | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/test/Capacitor.App.Tests.Unit/EditionStepViewModelTests.cs b/test/Capacitor.App.Tests.Unit/EditionStepViewModelTests.cs
index 20b5850815..f2d7c4a2aa 100644
--- a/test/Capacitor.App.Tests.Unit/EditionStepViewModelTests.cs
+++ b/test/Capacitor.App.Tests.Unit/EditionStepViewModelTests.cs
@@ -185,12 +185,12 @@ public async Task The_pane_shows_the_cards_in_place_of_next_and_the_cloud_card_r
         await Assert.That(after).IsEqualTo(WizardStepId.SignIn);
     }
 
-    /// The reason is the card's own footer, not a sibling between the two cards, and the card
-    /// carries it as help text while it refuses the choice.
+    /// The footer sits inside a disabled button, whose template may fade everything it holds;
+    /// the reason is the one part of the card that must stay at full strength.
     [Test]
     [NotInParallel("AvaloniaSession")]
     public async Task An_unavailable_local_card_says_why_in_its_own_footer() {
-        var (inCard, footerShown, enabled, help) = await AvaloniaSession.DispatchAsync(async () => {
+        var (inCard, footerShown, enabled, help, footerOpacity, headOpacity) = await AvaloniaSession.DispatchAsync(async () => {
             var edition = new EditionStepViewModel(
                 CliTelemetry.Disabled(TimeProvider.System).Funnel, () => EditionStepViewModel.UnsupportedPlatform);
             var vm = new OnboardingViewModel([edition, new FakeWizardStep(WizardStepId.SignIn)]);
@@ -202,8 +202,9 @@ public async Task An_unavailable_local_card_says_why_in_its_own_footer() {
 
             var local = window.GetVisualDescendants().OfType<Button>().First(c => c.Name == "LocalEditionButton");
             var reason = window.GetVisualDescendants().OfType<TextBlock>().First(c => c.Name == "LocalUnavailableText");
+            var head = local.GetVisualDescendants().OfType<Grid>().First(g => g.Classes.Contains("onboardingEditionHead"));
             var result = (reason.GetVisualAncestors().Contains(local), reason.IsEffectivelyVisible, local.IsEffectivelyEnabled,
-                Avalonia.Automation.AutomationProperties.GetHelpText(local));
+                Avalonia.Automation.AutomationProperties.GetHelpText(local), EffectiveOpacity(reason), EffectiveOpacity(head));
 
             window.Close();
             Dispatcher.UIThread.RunJobs();
@@ -215,6 +216,11 @@ public async Task An_unavailable_local_card_says_why_in_its_own_footer() {
         await Assert.That(footerShown).IsTrue();
         await Assert.That(enabled).IsFalse();
         await Assert.That(help).IsEqualTo(EditionStepViewModel.UnsupportedPlatform);
+        await Assert.That(footerOpacity).IsEqualTo(1.0);
+        await Assert.That(headOpacity).IsEqualTo(0.5);
+
+        static double EffectiveOpacity(Avalonia.Visual visual) =>
+            visual.GetSelfAndVisualAncestors().Aggregate(1.0, (opacity, v) => opacity * v.Opacity);
     }
 
     [Test]