From acb4c50743458cdf4a6b7817dc51c8e936f565fa Mon Sep 17 00:00:00 2001
From: Hazel Granados <hazel.granados@protonmail.com>
Date: Sat, 10 Oct 2026 17:01:09 -0500
Subject: [PATCH 1/8] docs(roadmap): plan v1.1.1 accessibility fixes from the
 audit

---
 ROADMAP.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/ROADMAP.md b/ROADMAP.md
index 86a91b6..3b496f8 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -225,6 +225,18 @@ Each release's notes say what it brought, and the decisions above say why. The c
 | [0.2: Safe, searchable and shareable](https://github.com/hazeliscoding/prompuff/releases/tag/v0.2.0) | 2026-10-07 | Backups, Recently deleted, FTS5 search, remembered values and `.zip` sharing |
 | [0.1: MVP](https://github.com/hazeliscoding/prompuff/releases/tag/v0.1.0) | 2026-10-07 | The library, `{{variables}}`, versions, Markdown import and export, and updates |
 
+## v1.1.1: Accessibility fixes
+
+An audit on 2026-10-10 went through the UI tests' screenshots, the themes and the views. These are what it found.
+
+- [ ] Screen readers and the keyboard: the rating takes the keyboard and reads out as "Usefulness, Solid", toasts and Quick save's error are announced, a favorite reads as one, Show details says when it's open, and the workflow's step strip moves with Left and Right.
+- [ ] Contrast and focus: danger buttons on hover, the focused list row against a picked one, the picked option in segmented controls, control edges and empty rating pips at 3:1, counts on the active sidebar row and tags on their tinted fill, and focus outlines that follow each control's corners. `ThemeTests` holds every theme to the new pairs.
+- [ ] Layout: long dialog titles wrap, the library and Settings fit the 960-pixel minimum width with a screenshot test at that size, toasts stay clear of the buttons beneath them, the Render tab scrolls once, the data folder's path shows in full on hover, and Settings sections share one spacing.
+- [ ] Copy and polish: Quick save's button says Save, the list view shows the rating's word, and small icon buttons use one icon size.
+- [ ] Publish v1.1.1.
+
+**Done when:** a screen reader reads a prompt's rating and favorite and announces a toast, the library and Settings fit a 960 × 600 window, and `ThemeTests` holds all thirteen themes to the new pairs.
+
 ## Getting found
 
 These need no release. Each lands as its own pull request whenever it's ready, alongside the milestones below.

From d56f8cd4796a2ebd62b1e580b17b84298e7a98ce Mon Sep 17 00:00:00 2001
From: Hazel Granados <hazel.granados@protonmail.com>
Date: Sat, 10 Oct 2026 17:14:36 -0500
Subject: [PATCH 2/8] fix(a11y): let the keyboard rate a prompt and read the
 rating aloud

The editor's rating took only clicks. It now takes Tab focus with a teal ring, steps with the arrow keys, jumps with Home, End and the digits, and clears with Delete. Screen readers read it as a Usefulness slider whose value is the rating's word.
---
 src/Prompuff.App/Controls/Tones.cs            | 88 ++++++++++++++++++-
 src/Prompuff.App/Themes/Controls.axaml        |  4 +
 src/Prompuff.App/Views/PromptEditorView.axaml |  3 +-
 .../Prompuff.App.Tests/AccessibilityTests.cs  | 49 +++++++++++
 4 files changed, 141 insertions(+), 3 deletions(-)

diff --git a/src/Prompuff.App/Controls/Tones.cs b/src/Prompuff.App/Controls/Tones.cs
index 0d61a75..61f39ea 100644
--- a/src/Prompuff.App/Controls/Tones.cs
+++ b/src/Prompuff.App/Controls/Tones.cs
@@ -1,4 +1,7 @@
 using Avalonia;
+using Avalonia.Automation;
+using Avalonia.Automation.Peers;
+using Avalonia.Automation.Provider;
 using Avalonia.Controls;
 using Avalonia.Controls.Primitives;
 using Avalonia.Input;
@@ -94,7 +97,8 @@ public object? RemoveCommandParameter
 }
 
 /// <summary>Five small squares showing usefulness from 1 to 5. Clicking a square sets the rating;
-/// clicking the current rating clears it.</summary>
+/// clicking the current rating clears it. When it's interactive it also takes the keyboard, and screen
+/// readers read it as a slider whose value is the rating's word, such as "Solid".</summary>
 public sealed class RatingPips : Control
 {
     public static readonly StyledProperty<int?> ValueProperty =
@@ -115,12 +119,21 @@ public sealed class RatingPips : Control
     public static readonly StyledProperty<Avalonia.Media.IBrush?> EmptyBrushProperty =
         AvaloniaProperty.Register<RatingPips, Avalonia.Media.IBrush?>(nameof(EmptyBrush));
 
+    /// <summary>The ring drawn around the pips while they have keyboard focus; styles set it on :focus-visible.</summary>
+    public static readonly StyledProperty<Avalonia.Media.IBrush?> FocusBrushProperty =
+        AvaloniaProperty.Register<RatingPips, Avalonia.Media.IBrush?>(nameof(FocusBrush));
+
+    private const double FocusInset = 3;
+
     private int? _hover;
 
     static RatingPips()
     {
-        AffectsRender<RatingPips>(ValueProperty, FilledBrushProperty, EmptyBrushProperty);
+        AffectsRender<RatingPips>(ValueProperty, FilledBrushProperty, EmptyBrushProperty, FocusBrushProperty);
         AffectsMeasure<RatingPips>(PipSizeProperty, SpacingProperty);
+        IsInteractiveProperty.Changed.AddClassHandler<RatingPips>((pips, _) => pips.Focusable = pips.IsInteractive);
+        ValueProperty.Changed.AddClassHandler<RatingPips>((pips, e) =>
+            (ControlAutomationPeer.FromElement(pips) as RatingPipsAutomationPeer)?.RaiseValueChanged(e.OldValue as int?, e.NewValue as int?));
     }
 
     public int? Value
@@ -159,6 +172,12 @@ public Avalonia.Media.IBrush? EmptyBrush
         set => SetValue(EmptyBrushProperty, value);
     }
 
+    public Avalonia.Media.IBrush? FocusBrush
+    {
+        get => GetValue(FocusBrushProperty);
+        set => SetValue(FocusBrushProperty, value);
+    }
+
     protected override Size MeasureOverride(Size availableSize) => new(PipSize * 5 + Spacing * 4, PipSize);
 
     public override void Render(Avalonia.Media.DrawingContext context)
@@ -170,8 +189,42 @@ public override void Render(Avalonia.Media.DrawingContext context)
             var rect = new Rect(i * (PipSize + Spacing), (Bounds.Height - PipSize) / 2, PipSize, PipSize);
             context.DrawRectangle(i < shown ? FilledBrush : EmptyBrush, null, rect, radius, radius);
         }
+
+        if (FocusBrush is { } focus)
+        {
+            var ring = new Rect(Bounds.Size).Inflate(FocusInset);
+            context.DrawRectangle(null, new Avalonia.Media.Pen(focus, 1.5), ring, radius + FocusInset, radius + FocusInset);
+        }
+    }
+
+    protected override void OnKeyDown(KeyEventArgs e)
+    {
+        base.OnKeyDown(e);
+        if (!IsInteractive || e.Handled || e.KeyModifiers != KeyModifiers.None || RatingForKey(e.Key, Value ?? 0) is not { } next)
+        {
+            return;
+        }
+
+        Value = next == 0 ? null : next;
+        e.Handled = true;
     }
 
+    /// <summary>The rating a key moves to, where 0 clears it: arrows step, Home and End jump to the ends, and 0 to 5
+    /// pick one. Other keys return null.</summary>
+    public static int? RatingForKey(Key key, int current) => key switch
+    {
+        Key.Right or Key.Up => Math.Min(current + 1, 5),
+        Key.Left or Key.Down => Math.Max(current - 1, 0),
+        Key.Home => 1,
+        Key.End => 5,
+        Key.Delete or Key.Back => 0,
+        >= Key.D0 and <= Key.D5 => key - Key.D0,
+        >= Key.NumPad0 and <= Key.NumPad5 => key - Key.NumPad0,
+        _ => null,
+    };
+
+    protected override AutomationPeer OnCreateAutomationPeer() => new RatingPipsAutomationPeer(this);
+
     protected override void OnPointerMoved(PointerEventArgs e)
     {
         base.OnPointerMoved(e);
@@ -209,3 +262,34 @@ protected override void OnPointerPressed(PointerPressedEventArgs e)
         return index is >= 1 and <= 5 ? index : null;
     }
 }
+
+/// <summary>Reads the rating as a slider whose value is its word ("Solid"), which screen readers say aloud, and
+/// lets them set it by word or number.</summary>
+public sealed class RatingPipsAutomationPeer(RatingPips owner) : ControlAutomationPeer(owner), IValueProvider
+{
+    private RatingPips Pips => (RatingPips)Owner;
+
+    public bool IsReadOnly => !Pips.IsInteractive;
+
+    public string? Value => ViewModels.Format.Rating(Pips.Value);
+
+    public void SetValue(string? value)
+    {
+        var rating = int.TryParse(value, out var number)
+            ? number
+            : Enumerable.Range(0, 6).FirstOrDefault(i => string.Equals(ViewModels.Format.Rating(i), value?.Trim(), StringComparison.OrdinalIgnoreCase), -1);
+        if (!IsReadOnly && rating is >= 0 and <= 5)
+        {
+            Pips.Value = rating == 0 ? null : rating;
+        }
+    }
+
+    internal void RaiseValueChanged(int? oldValue, int? newValue) =>
+        RaisePropertyChangedEvent(ValuePatternIdentifiers.ValueProperty, ViewModels.Format.Rating(oldValue), ViewModels.Format.Rating(newValue));
+
+    protected override AutomationControlType GetAutomationControlTypeCore() => AutomationControlType.Slider;
+
+    protected override bool IsContentElementCore() => Pips.IsInteractive;
+
+    protected override bool IsControlElementCore() => Pips.IsInteractive;
+}
diff --git a/src/Prompuff.App/Themes/Controls.axaml b/src/Prompuff.App/Themes/Controls.axaml
index 3e08ba1..0461633 100644
--- a/src/Prompuff.App/Themes/Controls.axaml
+++ b/src/Prompuff.App/Themes/Controls.axaml
@@ -634,6 +634,10 @@
     <Setter Property="FilledBrush" Value="{DynamicResource LavenderBrush}" />
     <Setter Property="EmptyBrush" Value="{DynamicResource Bg4Brush}" />
     <Setter Property="VerticalAlignment" Value="Center" />
+    <Setter Property="FocusAdorner" Value="{x:Null}" />
+  </Style>
+  <Style Selector="c|RatingPips:focus-visible">
+    <Setter Property="FocusBrush" Value="{DynamicResource AccentBrush}" />
   </Style>
   <Style Selector="c|Puff">
     <Setter Property="BodyBrush" Value="{DynamicResource LavenderBrush}" />
diff --git a/src/Prompuff.App/Views/PromptEditorView.axaml b/src/Prompuff.App/Views/PromptEditorView.axaml
index 08760e2..68d1979 100644
--- a/src/Prompuff.App/Views/PromptEditorView.axaml
+++ b/src/Prompuff.App/Views/PromptEditorView.axaml
@@ -206,7 +206,8 @@
               <TextBlock DockPanel.Dock="Top" Classes="label" Text="WHY THIS WORKED" Margin="0,0,0,8" />
               <StackPanel DockPanel.Dock="Bottom" Orientation="Horizontal" Spacing="8" Margin="0,10,0,0">
                 <TextBlock Classes="compact faint" Text="Usefulness" VerticalAlignment="Center" />
-                <c:RatingPips Value="{Binding Rating}" IsInteractive="True" PipSize="14" Spacing="4" ToolTip.Tip="Click to rate; click again to clear" />
+                <c:RatingPips Value="{Binding Rating}" IsInteractive="True" PipSize="14" Spacing="4" AutomationProperties.Name="Usefulness"
+                              ToolTip.Tip="Click or use the arrow keys to rate; click again to clear" />
                 <TextBlock Classes="compact faint" Text="{Binding RatingLabel}" VerticalAlignment="Center" />
               </StackPanel>
               <TextBox Classes="notes" MinHeight="140" Text="{Binding Notes}" PlaceholderText="Why did this work? Notes to your future self." />
diff --git a/tests/Prompuff.App.Tests/AccessibilityTests.cs b/tests/Prompuff.App.Tests/AccessibilityTests.cs
index e87f4b7..1e0bd9e 100644
--- a/tests/Prompuff.App.Tests/AccessibilityTests.cs
+++ b/tests/Prompuff.App.Tests/AccessibilityTests.cs
@@ -1,8 +1,12 @@
 using Avalonia.Automation.Peers;
+using Avalonia.Automation.Provider;
 using Avalonia.Controls;
 using Avalonia.Controls.Primitives;
+using Avalonia.Headless;
 using Avalonia.Headless.XUnit;
+using Avalonia.Input;
 using Avalonia.VisualTree;
+using Prompuff.App.Controls;
 using Prompuff.App.ViewModels;
 using Prompuff.Application.Settings;
 
@@ -115,4 +119,49 @@ public async Task Every_button_box_and_list_has_a_name_a_screen_reader_can_read(
 
         Assert.True(failures.Count == 0, $"{failures.Count} controls a screen reader can't name:\n" + string.Join("\n", failures.Distinct()));
     }
+
+    /// <summary>The editor's rating takes the keyboard, shows focus, and reads as "Usefulness" with its word as the value.</summary>
+    [AvaloniaFact]
+    public async Task The_rating_takes_the_keyboard_and_reads_out_its_word()
+    {
+        await using var app = await AppHarness.StartAsync();
+        await app.ViewModel.Library.Items.First().OpenCommand.ExecuteAsync(null);
+        await app.SettleAsync();
+        var editor = Assert.IsType<PromptEditorViewModel>(app.ViewModel.CurrentPage);
+        var pips = app.Window.GetVisualDescendants().OfType<RatingPips>().Single(pips => pips.IsInteractive);
+
+        Assert.True(pips.Focusable);
+        pips.Focus(NavigationMethod.Tab);
+        await app.SettleAsync(30);
+        Assert.Contains(":focus-visible", pips.Classes);
+        Assert.NotNull(pips.FocusBrush);
+
+        async Task Press(PhysicalKey key)
+        {
+            app.Window.KeyPressQwerty(key, RawInputModifiers.None);
+            await app.SettleAsync(30);
+        }
+
+        await Press(PhysicalKey.Digit3);
+        Assert.Equal(3, editor.Rating);
+        await Press(PhysicalKey.ArrowRight);
+        Assert.Equal(4, editor.Rating);
+        app.Screenshot("editor-rating-keyboard");
+
+        var peer = ControlAutomationPeer.CreatePeerForElement(pips);
+        Assert.Equal("Usefulness", peer.GetName());
+        Assert.Equal(AutomationControlType.Slider, peer.GetAutomationControlType());
+        var value = Assert.IsAssignableFrom<IValueProvider>(peer);
+        Assert.Equal("Great", value.Value);
+        value.SetValue("Meh");
+        Assert.Equal(1, editor.Rating);
+
+        await Press(PhysicalKey.ArrowLeft);
+        Assert.Null(editor.Rating);
+        Assert.Equal("Unrated", value.Value);
+        await Press(PhysicalKey.End);
+        Assert.Equal(5, editor.Rating);
+        await Press(PhysicalKey.Delete);
+        Assert.Null(editor.Rating);
+    }
 }

From aef72db68060acc45311fe7bd871ff393133f7cc Mon Sep 17 00:00:00 2001
From: Hazel Granados <hazel.granados@protonmail.com>
Date: Sat, 10 Oct 2026 17:14:58 -0500
Subject: [PATCH 3/8] docs(guide): rate a prompt from the keyboard

---
 docs/user-guide.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/user-guide.md b/docs/user-guide.md
index 5f345a1..cfcb7f9 100644
--- a/docs/user-guide.md
+++ b/docs/user-guide.md
@@ -74,7 +74,7 @@ A prompt lives in one collection, or none, and can have any number of tags.
 
 A prompt has a **title**, a one-line **description**, the **prompt** itself (Markdown), and **Why this worked**, notes to your future self.
 
-**Saving:** changes to those four fields wait for **Save** (Ctrl+S), and each save makes a new version. Prompuff also saves when you leave the prompt or close the window. The favorite heart (Ctrl+D), the usefulness rating (Meh, Okay, Solid, Great, Cooked), the collection and the tags save as soon as you change them, and don't make versions.
+**Saving:** changes to those four fields wait for **Save** (Ctrl+S), and each save makes a new version. Prompuff also saves when you leave the prompt or close the window. The favorite heart (Ctrl+D), the usefulness rating (Meh, Okay, Solid, Great, Cooked; Tab to it and use the arrow keys or 0 to 5), the collection and the tags save as soon as you change them, and don't make versions.
 
 **Copying:** **Copy** copies the prompt with your variable values filled in. The **…** menu has **Copy template with variables** (Ctrl+Shift+C), which copies it as written.
 

From d1437098b19881feaf44b37eef667358415a2ee3 Mon Sep 17 00:00:00 2001
From: Hazel Granados <hazel.granados@protonmail.com>
Date: Sat, 10 Oct 2026 17:30:43 -0500
Subject: [PATCH 4/8] fix(a11y): announce toasts and Quick save's error to
 screen readers

Each is now a live region that stays in the window and takes the message as its name. Avalonia's peers don't report a name change, which is what Windows listens for, so AccessibleNames reports it for live regions. Checked with UI Automation on Windows: the error and a toast each raised LiveRegionChanged with their text.
---
 src/Prompuff.App/Controls/AccessibleNames.cs  | 10 ++++++
 src/Prompuff.App/ViewModels/ShellServices.cs  |  3 ++
 src/Prompuff.App/Views/MainWindow.axaml       | 20 +++++++----
 .../Prompuff.App.Tests/AccessibilityTests.cs  | 35 +++++++++++++++++++
 4 files changed, 62 insertions(+), 6 deletions(-)

diff --git a/src/Prompuff.App/Controls/AccessibleNames.cs b/src/Prompuff.App/Controls/AccessibleNames.cs
index b896cd6..792bb4e 100644
--- a/src/Prompuff.App/Controls/AccessibleNames.cs
+++ b/src/Prompuff.App/Controls/AccessibleNames.cs
@@ -1,5 +1,6 @@
 using Avalonia;
 using Avalonia.Automation;
+using Avalonia.Automation.Peers;
 using Avalonia.Controls;
 using Avalonia.Data;
 using Avalonia.LogicalTree;
@@ -25,6 +26,15 @@ public static void Install()
         Control.UnloadedEvent.AddClassHandler<Button>((button, _) => Stop(button));
         Control.LoadedEvent.AddClassHandler<TextBox>((box, _) => Follow(box));
         Control.UnloadedEvent.AddClassHandler<TextBox>((box, _) => Stop(box));
+
+        // Windows announces a live region when its name changes, but Avalonia's peers don't report that change, so report it here.
+        AutomationProperties.NameProperty.Changed.AddClassHandler<Control>((control, e) =>
+        {
+            if (AutomationProperties.GetLiveSetting(control) != AutomationLiveSetting.Off)
+            {
+                ControlAutomationPeer.FromElement(control)?.RaisePropertyChangedEvent(AutomationElementIdentifiers.NameProperty, e.OldValue, e.NewValue);
+            }
+        });
     }
 
     /// <summary>The name this control's own content gives it: its text, its tooltip, or its placeholder.</summary>
diff --git a/src/Prompuff.App/ViewModels/ShellServices.cs b/src/Prompuff.App/ViewModels/ShellServices.cs
index 8f51b14..8255a63 100644
--- a/src/Prompuff.App/ViewModels/ShellServices.cs
+++ b/src/Prompuff.App/ViewModels/ShellServices.cs
@@ -245,6 +245,9 @@ public sealed partial class ToastViewModel(string title, string? subtitle, bool
     public string? Subtitle { get; } = subtitle;
     public bool HasSubtitle => !string.IsNullOrEmpty(Subtitle);
     public bool IsHappy { get; } = isHappy;
+
+    /// <summary>What a screen reader says when the toast appears. Titles end with a full stop, so the subtitle follows on.</summary>
+    public string Announcement => HasSubtitle ? $"{Title} {Subtitle}" : Title;
 }
 
 public sealed partial class ToastService(AppearanceState appearance) : ObservableObject
diff --git a/src/Prompuff.App/Views/MainWindow.axaml b/src/Prompuff.App/Views/MainWindow.axaml
index 8394813..078e27f 100644
--- a/src/Prompuff.App/Views/MainWindow.axaml
+++ b/src/Prompuff.App/Views/MainWindow.axaml
@@ -353,6 +353,10 @@
             </Grid>
           </Border>
 
+          <!-- Stays in the window with no size, so screen readers hear its name change when an error appears. -->
+          <Panel x:Name="QuickSaveErrorAnnouncer" DockPanel.Dock="Bottom" Height="0"
+                 AutomationProperties.LiveSetting="Assertive" AutomationProperties.AccessibilityView="Content" AutomationProperties.ControlTypeOverride="Text" AutomationProperties.Name="{Binding Error}" />
+
           <StackPanel Margin="18,14" Spacing="12">
             <TextBox Classes="mono"
                      Height="110"
@@ -464,17 +468,20 @@
       </Panel>
     </Grid>
 
-    <!-- Toast -->
-    <Border HorizontalAlignment="Right"
-            VerticalAlignment="Bottom"
-            Margin="20"
-            Padding="12,10,16,10"
+    <!-- Toast. The outer panel stays in the window, so screen readers hear its name change as a toast appears. -->
+    <Panel x:Name="ToastAnnouncer"
+           HorizontalAlignment="Right"
+           VerticalAlignment="Bottom"
+           Margin="20"
+           IsHitTestVisible="False"
+           AutomationProperties.LiveSetting="Polite" AutomationProperties.AccessibilityView="Content" AutomationProperties.ControlTypeOverride="Text"
+           AutomationProperties.Name="{Binding Toasts.Current.Announcement}">
+    <Border Padding="12,10,16,10"
             CornerRadius="8"
             Background="{DynamicResource Bg3Brush}"
             BorderBrush="{DynamicResource Border2Brush}"
             BorderThickness="1"
             BoxShadow="{DynamicResource Shadow3}"
-            IsHitTestVisible="False"
             IsVisible="{Binding Toasts.Current, Converter={x:Static ObjectConverters.IsNotNull}}">
       <Panel DataContext="{Binding Toasts.Current}">
       <StackPanel Orientation="Horizontal" Spacing="10" x:DataType="vm:ToastViewModel">
@@ -487,5 +494,6 @@
       </StackPanel>
       </Panel>
     </Border>
+    </Panel>
   </Panel>
 </Window>
diff --git a/tests/Prompuff.App.Tests/AccessibilityTests.cs b/tests/Prompuff.App.Tests/AccessibilityTests.cs
index 1e0bd9e..a2bde65 100644
--- a/tests/Prompuff.App.Tests/AccessibilityTests.cs
+++ b/tests/Prompuff.App.Tests/AccessibilityTests.cs
@@ -1,3 +1,4 @@
+using Avalonia.Automation;
 using Avalonia.Automation.Peers;
 using Avalonia.Automation.Provider;
 using Avalonia.Controls;
@@ -164,4 +165,38 @@ async Task Press(PhysicalKey key)
         await Press(PhysicalKey.Delete);
         Assert.Null(editor.Rating);
     }
+
+    /// <summary>
+    /// Toasts and Quick save's error are live regions. Windows tells screen readers about one when its name changes, and only
+    /// for an element already in the window, so each one stays there and takes the message as its name.
+    /// </summary>
+    [AvaloniaFact]
+    public async Task Toasts_and_quick_save_errors_are_announced()
+    {
+        await using var app = await AppHarness.StartAsync();
+        Control Named(string name) => app.Window.GetVisualDescendants().OfType<Control>().Single(control => control.Name == name);
+
+        var toast = Named("ToastAnnouncer");
+        Assert.True(toast.IsEffectivelyVisible, "The toast's announcer is in the window before any toast");
+        var toastPeer = ControlAutomationPeer.CreatePeerForElement(toast);
+        Assert.Equal(AutomationLiveSetting.Polite, toastPeer.GetLiveSetting());
+        var renamed = 0;
+        toastPeer.PropertyChanged += (_, e) => renamed += e.Property == AutomationElementIdentifiers.NameProperty ? 1 : 0;
+
+        app.ViewModel.Toasts.Show("Moved to Recently deleted.", "UI Mockup Generator", isHappy: false);
+        await app.SettleAsync();
+        Assert.Equal("Moved to Recently deleted. UI Mockup Generator", toastPeer.GetName());
+        Assert.True(renamed > 0, "Changing the name raises the event screen readers listen for");
+
+        await app.ViewModel.QuickSave.OpenAsync();
+        await app.SettleAsync();
+        app.ViewModel.QuickSave.Text = string.Empty;
+        var error = Named("QuickSaveErrorAnnouncer");
+        Assert.True(error.IsEffectivelyVisible, "Quick save's announcer is in the window before any error");
+        var errorPeer = ControlAutomationPeer.CreatePeerForElement(error);
+        Assert.Equal(AutomationLiveSetting.Assertive, errorPeer.GetLiveSetting());
+        await app.ViewModel.QuickSave.SaveCommand.ExecuteAsync(null);
+        await app.SettleAsync();
+        Assert.Equal("Paste or type the prompt first.", errorPeer.GetName());
+    }
 }

From 9c7dc7229e5a94e950bd91eea287215108d419e0 Mon Sep 17 00:00:00 2001
From: Hazel Granados <hazel.granados@protonmail.com>
Date: Sat, 10 Oct 2026 17:30:56 -0500
Subject: [PATCH 5/8] fix(a11y): name the heart after what it will do

Every heart was read as "Favorite", whether the prompt was one or not. It's now "Add to favorites" or "Remove from favorites", in its tooltip and for screen readers.
---
 .../ViewModels/LibraryViewModel.cs            |  3 +++
 .../ViewModels/PromptEditorViewModel.cs       |  2 ++
 src/Prompuff.App/ViewModels/ShellServices.cs  |  3 +++
 src/Prompuff.App/Views/LibraryView.axaml      |  4 ++--
 src/Prompuff.App/Views/PromptEditorView.axaml |  2 +-
 .../Prompuff.App.Tests/AccessibilityTests.cs  | 24 +++++++++++++++++++
 6 files changed, 35 insertions(+), 3 deletions(-)

diff --git a/src/Prompuff.App/ViewModels/LibraryViewModel.cs b/src/Prompuff.App/ViewModels/LibraryViewModel.cs
index 234157f..dc5de98 100644
--- a/src/Prompuff.App/ViewModels/LibraryViewModel.cs
+++ b/src/Prompuff.App/ViewModels/LibraryViewModel.cs
@@ -71,8 +71,11 @@ public PromptCardViewModel(LibraryViewModel owner, PromptSummary summary, string
     public bool IsDeleted => _summary.DeletedAt is not null;
 
     [ObservableProperty]
+    [NotifyPropertyChangedFor(nameof(FavoriteLabel))]
     private bool _isFavorite;
 
+    public string FavoriteLabel => Format.Favorite(IsFavorite);
+
     /// <summary>The card the arrow keys are on.</summary>
     [ObservableProperty]
     private bool _isCurrent;
diff --git a/src/Prompuff.App/ViewModels/PromptEditorViewModel.cs b/src/Prompuff.App/ViewModels/PromptEditorViewModel.cs
index 03b33b8..dc4b9b7 100644
--- a/src/Prompuff.App/ViewModels/PromptEditorViewModel.cs
+++ b/src/Prompuff.App/ViewModels/PromptEditorViewModel.cs
@@ -158,6 +158,7 @@ public PromptEditorViewModel(
     private string _notes = string.Empty;
 
     [ObservableProperty]
+    [NotifyPropertyChangedFor(nameof(FavoriteLabel))]
     private bool _isFavorite;
 
     [ObservableProperty]
@@ -242,6 +243,7 @@ public PromptEditorViewModel(
     public string VariableCountLabel => Format.Count(Variables.Count, "variable") + " detected";
     public string CharsLabel => $"{Body.Length.ToString("N0", CultureInfo.InvariantCulture)} chars · ~{(Body.Length / 4).ToString("N0", CultureInfo.InvariantCulture)} tokens";
     public string RatingLabel => Format.Rating(Rating);
+    public string FavoriteLabel => Format.Favorite(IsFavorite) + " (Ctrl D)";
     public string CollectionLabel => SelectedCollection.Name;
     public string CollectionTone => SelectedCollection.Tone;
     public string VersionLabel => IsNew ? "Not saved yet" : $"v{CurrentVersion} · edited {Format.Relative(UpdatedAt, _time.GetUtcNow())}";
diff --git a/src/Prompuff.App/ViewModels/ShellServices.cs b/src/Prompuff.App/ViewModels/ShellServices.cs
index 8255a63..8d0fe6d 100644
--- a/src/Prompuff.App/ViewModels/ShellServices.cs
+++ b/src/Prompuff.App/ViewModels/ShellServices.cs
@@ -393,6 +393,9 @@ internal static class Format
 
     public static string Rating(int? rating) => RatingLabels[Math.Clamp(rating ?? 0, 0, 5)];
 
+    /// <summary>The heart's tooltip, which is also what screen readers call it, so it says whether the prompt is a favorite.</summary>
+    public static string Favorite(bool isFavorite) => isFavorite ? "Remove from favorites" : "Add to favorites";
+
     public static string Count(int count, string singular, string? plural = null) =>
         $"{count.ToString(CultureInfo.InvariantCulture)} {(count == 1 ? singular : plural ?? singular + "s")}";
 
diff --git a/src/Prompuff.App/Views/LibraryView.axaml b/src/Prompuff.App/Views/LibraryView.axaml
index 404b177..ee5ad4d 100644
--- a/src/Prompuff.App/Views/LibraryView.axaml
+++ b/src/Prompuff.App/Views/LibraryView.axaml
@@ -264,7 +264,7 @@
                     </Panel>
                     <TextBlock Grid.Column="1" Classes="card-title" Text="{Binding Title}" TextWrapping="Wrap" TextTrimming="CharacterEllipsis" />
                     <Button Grid.Column="2" Classes="ghost icon sm" Classes.active="{Binding IsFavorite}" Margin="0,-3,-4,0" VerticalAlignment="Top"
-                            Command="{Binding ToggleFavoriteCommand}" ToolTip.Tip="Favorite" IsVisible="{Binding !IsDeleted}">
+                            Command="{Binding ToggleFavoriteCommand}" ToolTip.Tip="{Binding FavoriteLabel}" IsVisible="{Binding !IsDeleted}">
                       <c:Icon Kind="Heart" Size="14" IsFilled="{Binding IsFavorite}" />
                     </Button>
                   </Grid>
@@ -329,7 +329,7 @@
                       <c:TagChipStrip Grid.Column="2" Names="{Binding TagNames}" Wrap="False" VerticalAlignment="Center" ClipToBounds="True" />
                       <c:RatingPips Grid.Column="3" Value="{Binding Rating, Mode=OneWay}" ToolTip.Tip="{Binding RatingLabel}" HorizontalAlignment="Left" />
                       <TextBlock Grid.Column="4" Classes="data faint" Text="{Binding EditedLabel}" ToolTip.Tip="{Binding EditedTooltip}" VerticalAlignment="Center" />
-                      <Button Grid.Column="5" Classes="ghost icon sm" Classes.active="{Binding IsFavorite}" Command="{Binding ToggleFavoriteCommand}" ToolTip.Tip="Favorite" IsVisible="{Binding !IsDeleted}">
+                      <Button Grid.Column="5" Classes="ghost icon sm" Classes.active="{Binding IsFavorite}" Command="{Binding ToggleFavoriteCommand}" ToolTip.Tip="{Binding FavoriteLabel}" IsVisible="{Binding !IsDeleted}">
                         <c:Icon Kind="Heart" Size="14" IsFilled="{Binding IsFavorite}" />
                       </Button>
                       <Button Grid.Column="5" Classes="ghost icon sm" Command="{Binding RestoreCommand}" ToolTip.Tip="Restore" IsVisible="{Binding IsDeleted}">
diff --git a/src/Prompuff.App/Views/PromptEditorView.axaml b/src/Prompuff.App/Views/PromptEditorView.axaml
index 68d1979..139267e 100644
--- a/src/Prompuff.App/Views/PromptEditorView.axaml
+++ b/src/Prompuff.App/Views/PromptEditorView.axaml
@@ -53,7 +53,7 @@
                    Text="{Binding Title}"
                    PlaceholderText="Untitled prompt" />
           <StackPanel Grid.Column="1" Orientation="Horizontal" Spacing="6" VerticalAlignment="Center">
-            <Button Classes="ghost icon" Classes.active="{Binding IsFavorite}" Command="{Binding ToggleFavoriteCommand}" ToolTip.Tip="Favorite (Ctrl D)">
+            <Button Classes="ghost icon" Classes.active="{Binding IsFavorite}" Command="{Binding ToggleFavoriteCommand}" ToolTip.Tip="{Binding FavoriteLabel}">
               <c:Icon Kind="Heart" Size="15" IsFilled="{Binding IsFavorite}" />
             </Button>
             <Button Command="{Binding DuplicateCommand}" IsEnabled="{Binding !IsNew}" ToolTip.Tip="Make a copy with its own history">
diff --git a/tests/Prompuff.App.Tests/AccessibilityTests.cs b/tests/Prompuff.App.Tests/AccessibilityTests.cs
index a2bde65..f404e3a 100644
--- a/tests/Prompuff.App.Tests/AccessibilityTests.cs
+++ b/tests/Prompuff.App.Tests/AccessibilityTests.cs
@@ -199,4 +199,28 @@ public async Task Toasts_and_quick_save_errors_are_announced()
         await app.SettleAsync();
         Assert.Equal("Paste or type the prompt first.", errorPeer.GetName());
     }
+
+    /// <summary>A heart is read as what it will do, so a screen reader can tell a favorite from one that isn't.</summary>
+    [AvaloniaFact]
+    public async Task A_heart_says_whether_its_prompt_is_a_favorite()
+    {
+        await using var app = await AppHarness.StartAsync();
+        var id = app.ViewModel.Library.Items.First().Id;
+        // A favorite change refreshes the library, which makes new cards, so look the card up each time.
+        PromptCardViewModel Card() => app.ViewModel.Library.Items.Single(card => card.Id == id);
+        string Heart() => ControlAutomationPeer.CreatePeerForElement(app.Window.GetVisualDescendants().OfType<Button>()
+            .First(button => button.DataContext == Card() && button.Command == Card().ToggleFavoriteCommand)).GetName();
+
+        var was = Card().IsFavorite;
+        Assert.Equal(was ? "Remove from favorites" : "Add to favorites", Heart());
+        await Card().ToggleFavoriteCommand.ExecuteAsync(null);
+        await app.SettleAsync();
+        Assert.Equal(was ? "Add to favorites" : "Remove from favorites", Heart());
+
+        await Card().OpenCommand.ExecuteAsync(null);
+        await app.SettleAsync();
+        var editor = Assert.IsType<PromptEditorViewModel>(app.ViewModel.CurrentPage);
+        var heart = app.Window.GetVisualDescendants().OfType<Button>().First(button => button.Command == editor.ToggleFavoriteCommand);
+        Assert.Equal(was ? "Add to favorites (Ctrl D)" : "Remove from favorites (Ctrl D)", ControlAutomationPeer.CreatePeerForElement(heart).GetName());
+    }
 }

From aba0641d90cc1f67175d2ead4f859bd955a9bf43 Mon Sep 17 00:00:00 2001
From: Hazel Granados <hazel.granados@protonmail.com>
Date: Sat, 10 Oct 2026 17:31:06 -0500
Subject: [PATCH 6/8] fix(a11y): let Show details say when the details are open

It kept the same words and chevron either way. Open, it reads "Hide details" with a downward chevron, in error dialogs and on the startup error.
---
 src/Prompuff.App/Views/MainWindow.axaml       | 13 ++++++++---
 .../Prompuff.App.Tests/AccessibilityTests.cs  | 22 +++++++++++++++++++
 2 files changed, 32 insertions(+), 3 deletions(-)

diff --git a/src/Prompuff.App/Views/MainWindow.axaml b/src/Prompuff.App/Views/MainWindow.axaml
index 078e27f..5a2a0ac 100644
--- a/src/Prompuff.App/Views/MainWindow.axaml
+++ b/src/Prompuff.App/Views/MainWindow.axaml
@@ -41,7 +41,12 @@
               <TextBlock Text="Open data folder" />
             </StackPanel>
           </Button>
-          <Button Classes="ghost" Content="Show details" IsVisible="{Binding HasDetails}" Command="{Binding ToggleDetailsCommand}" />
+          <Button Classes="ghost" IsVisible="{Binding HasDetails}" Command="{Binding ToggleDetailsCommand}">
+            <Panel>
+              <TextBlock Text="Show details" IsVisible="{Binding !ShowDetails}" />
+              <TextBlock Text="Hide details" IsVisible="{Binding ShowDetails}" />
+            </Panel>
+          </Button>
         </StackPanel>
         <Border Classes="well" Padding="10" IsVisible="{Binding ShowDetails}" MaxHeight="220">
           <ScrollViewer>
@@ -450,8 +455,10 @@
           <TextBox x:Name="DialogInput" IsVisible="{Binding HasInput}" Text="{Binding InputText}" PlaceholderText="{Binding InputPlaceholder}" Height="32" />
           <Button Classes="ghost sm" HorizontalAlignment="Left" IsVisible="{Binding HasDetails}" Command="{Binding ToggleDetailsCommand}" Margin="-8,0,0,0">
             <StackPanel Orientation="Horizontal" Spacing="6">
-              <c:Icon Kind="ChevronRight" Size="12" />
-              <TextBlock Text="Show details" />
+              <c:Icon Kind="ChevronRight" Size="12" IsVisible="{Binding !ShowDetails}" />
+              <c:Icon Kind="ChevronDown" Size="12" IsVisible="{Binding ShowDetails}" />
+              <TextBlock Text="Show details" IsVisible="{Binding !ShowDetails}" />
+              <TextBlock Text="Hide details" IsVisible="{Binding ShowDetails}" />
             </StackPanel>
           </Button>
           <Border Classes="well" Padding="10" MaxHeight="200" IsVisible="{Binding ShowDetails}">
diff --git a/tests/Prompuff.App.Tests/AccessibilityTests.cs b/tests/Prompuff.App.Tests/AccessibilityTests.cs
index f404e3a..4923aa6 100644
--- a/tests/Prompuff.App.Tests/AccessibilityTests.cs
+++ b/tests/Prompuff.App.Tests/AccessibilityTests.cs
@@ -223,4 +223,26 @@ string Heart() => ControlAutomationPeer.CreatePeerForElement(app.Window.GetVisua
         var heart = app.Window.GetVisualDescendants().OfType<Button>().First(button => button.Command == editor.ToggleFavoriteCommand);
         Assert.Equal(was ? "Add to favorites (Ctrl D)" : "Remove from favorites (Ctrl D)", ControlAutomationPeer.CreatePeerForElement(heart).GetName());
     }
+
+    /// <summary>Show details says when the details are open, in words and with its chevron.</summary>
+    [AvaloniaFact]
+    public async Task Show_details_says_when_the_details_are_open()
+    {
+        await using var app = await AppHarness.StartAsync();
+        var showing = app.ViewModel.Dialogs.ShowErrorAsync("Couldn't import that file.", "Your library is safe.", "System.IO.IOException: locked");
+        await app.SettleAsync();
+        var dialog = app.ViewModel.Dialogs.Current!;
+        var toggle = app.Window.GetVisualDescendants().OfType<Button>().Single(button => button.Command == dialog.ToggleDetailsCommand);
+        string Name() => ControlAutomationPeer.CreatePeerForElement(toggle).GetName();
+
+        Assert.Equal("Show details", Name());
+        dialog.ToggleDetailsCommand.Execute(null);
+        await app.SettleAsync();
+        Assert.Equal("Hide details", Name());
+        Assert.Contains(toggle.GetVisualDescendants().OfType<Icon>(), icon => icon.IsEffectivelyVisible && icon.Kind == "ChevronDown");
+        app.Screenshot("dialog-details-open");
+
+        app.ViewModel.Dialogs.CancelCurrent();
+        await showing;
+    }
 }

From a84745637afa28e4b92352c628882c4ef19a15d0 Mon Sep 17 00:00:00 2001
From: Hazel Granados <hazel.granados@protonmail.com>
Date: Sat, 10 Oct 2026 17:31:09 -0500
Subject: [PATCH 7/8] fix(workflows): point the step buttons left and right,
 like the strip

The Run tab's steps run across in a row, but Previous and Next showed up and down arrows. Adds Lucide's arrow-left to the generated icons.
---
 scripts/generate-icons.py                 | 1 +
 src/Prompuff.App/Controls/IconData.g.cs   | 1 +
 src/Prompuff.App/Views/WorkflowView.axaml | 4 ++--
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/scripts/generate-icons.py b/scripts/generate-icons.py
index 283e315..58102fb 100644
--- a/scripts/generate-icons.py
+++ b/scripts/generate-icons.py
@@ -89,6 +89,7 @@
     ("ArrowUp", "arrow-up"),
     ("ArrowDown", "arrow-down"),
     ("ArrowRight", "arrow-right"),
+    ("ArrowLeft", "arrow-left"),
     ("CircleCheck", "circle-check"),
     ("Plug", "plug"),
     ("Terminal", "terminal"),
diff --git a/src/Prompuff.App/Controls/IconData.g.cs b/src/Prompuff.App/Controls/IconData.g.cs
index 474990a..ec83049 100644
--- a/src/Prompuff.App/Controls/IconData.g.cs
+++ b/src/Prompuff.App/Controls/IconData.g.cs
@@ -65,6 +65,7 @@ internal static class IconData
             ["ArrowUp"] = "M 5 12 l 7 -7 l 7 7 M 12 19 V 5",
             ["ArrowDown"] = "M 12 5 v 14 M 19 12 l -7 7 l -7 -7",
             ["ArrowRight"] = "M 5 12 h 14 M 12 5 l 7 7 l -7 7",
+            ["ArrowLeft"] = "M 12 19 l -7 -7 l 7 -7 M 19 12 H 5",
             ["CircleCheck"] = "M 2 12 A 10 10 0 1 0 22 12 A 10 10 0 1 0 2 12 Z M 9 12 l 2 2 l 4 -4",
             ["Plug"] = "M 12 22 v -5 M 9 8 V 2 M 15 8 V 2 M 18 8 v 5 a 4 4 0 0 1 -4 4 h -4 a 4 4 0 0 1 -4 -4 V 8 Z",
             ["Terminal"] = "M 4 17 L 10 11 L 4 5 M 12 19 L 20 19",
diff --git a/src/Prompuff.App/Views/WorkflowView.axaml b/src/Prompuff.App/Views/WorkflowView.axaml
index 673bf82..4a123b3 100644
--- a/src/Prompuff.App/Views/WorkflowView.axaml
+++ b/src/Prompuff.App/Views/WorkflowView.axaml
@@ -290,10 +290,10 @@
                 <TextBlock Grid.Column="1" Classes="data" Text="{Binding FillLabel}" VerticalAlignment="Center"
                            Foreground="{DynamicResource MintTextBrush}" IsVisible="{Binding IsFullyFilled}" />
                 <Button Grid.Column="3" Classes="ghost sm" Command="{Binding PreviousStepCommand}" IsEnabled="{Binding CanGoBack}" VerticalAlignment="Center" ToolTip.Tip="Previous step">
-                  <c:Icon Kind="ArrowUp" Size="12" />
+                  <c:Icon Kind="ArrowLeft" Size="12" />
                 </Button>
                 <Button Grid.Column="4" Classes="ghost sm" Command="{Binding NextStepCommand}" IsEnabled="{Binding CanGoForward}" VerticalAlignment="Center" ToolTip.Tip="Next step">
-                  <c:Icon Kind="ArrowDown" Size="12" />
+                  <c:Icon Kind="ArrowRight" Size="12" />
                 </Button>
                 <Button Grid.Column="5" Classes="primary sm" Command="{Binding CopyStepCommand}" VerticalAlignment="Center" ToolTip.Tip="Copy, then move to the next step (Ctrl Enter)">
                   <StackPanel Orientation="Horizontal" Spacing="6">

From 80f75a001f1a1863f4f8cd3c60dd861f68d1aa70 Mon Sep 17 00:00:00 2001
From: Hazel Granados <hazel.granados@protonmail.com>
Date: Sat, 10 Oct 2026 17:31:31 -0500
Subject: [PATCH 8/8] docs(roadmap): tick the screen reader and keyboard fixes

---
 ROADMAP.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ROADMAP.md b/ROADMAP.md
index 3b496f8..f4c13b8 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -229,7 +229,7 @@ Each release's notes say what it brought, and the decisions above say why. The c
 
 An audit on 2026-10-10 went through the UI tests' screenshots, the themes and the views. These are what it found.
 
-- [ ] Screen readers and the keyboard: the rating takes the keyboard and reads out as "Usefulness, Solid", toasts and Quick save's error are announced, a favorite reads as one, Show details says when it's open, and the workflow's step strip moves with Left and Right.
+- [x] Screen readers and the keyboard: the rating takes the keyboard and reads out as "Usefulness, Solid", toasts and Quick save's error are announced, a heart says whether its prompt is a favorite, Show details says when it's open, and the workflow's Previous and Next buttons point left and right like its step strip.
 - [ ] Contrast and focus: danger buttons on hover, the focused list row against a picked one, the picked option in segmented controls, control edges and empty rating pips at 3:1, counts on the active sidebar row and tags on their tinted fill, and focus outlines that follow each control's corners. `ThemeTests` holds every theme to the new pairs.
 - [ ] Layout: long dialog titles wrap, the library and Settings fit the 960-pixel minimum width with a screenshot test at that size, toasts stay clear of the buttons beneath them, the Render tab scrolls once, the data folder's path shows in full on hover, and Settings sections share one spacing.
 - [ ] Copy and polish: Quick save's button says Save, the list view shows the rating's word, and small icon buttons use one icon size.