From a3ec0473904f318db05404eda7fc474f80f4734e Mon Sep 17 00:00:00 2001
From: Gil Desmarais <git@desmarais.de>
Date: Sat, 21 Mar 2026 15:27:27 +0100
Subject: [PATCH 1/3] Link included feeds to instance feed directory

---
 frontend/src/__tests__/App.test.tsx   |  3 ++-
 frontend/src/components/AppPanels.tsx | 12 +++++++++++-
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/frontend/src/__tests__/App.test.tsx b/frontend/src/__tests__/App.test.tsx
index af6bf619..87703b90 100644
--- a/frontend/src/__tests__/App.test.tsx
+++ b/frontend/src/__tests__/App.test.tsx
@@ -400,6 +400,7 @@ describe('App', () => {
   });
 
   it('shows the utility links in a user-focused order', () => {
+    window.history.replaceState({}, '', 'http://localhost:3000/#result');
     render(<App />);
 
     fireEvent.click(screen.getByRole('button', { name: 'More' }));
@@ -419,7 +420,7 @@ describe('App', () => {
     );
     expect(screen.getByRole('link', { name: 'Try included feeds' })).toHaveAttribute(
       'href',
-      'https://html2rss.github.io/web-application/how-to/use-included-configs/'
+      'https://html2rss.github.io/feed-directory/#!url=http%3A%2F%2Flocalhost%3A3000%2F'
     );
     expect(screen.getByRole('link', { name: 'Install from Docker Hub' })).toHaveAttribute(
       'href',
diff --git a/frontend/src/components/AppPanels.tsx b/frontend/src/components/AppPanels.tsx
index 59a8fd95..19d6f51d 100644
--- a/frontend/src/components/AppPanels.tsx
+++ b/frontend/src/components/AppPanels.tsx
@@ -255,6 +255,16 @@ export function UtilityStrip({
   onClearToken,
 }: UtilityStripProps) {
   const [isOpen, setIsOpen] = useState(false);
+  const includedFeedsHref = (() => {
+    const directoryUrl = new URL('https://html2rss.github.io/feed-directory/');
+    if (typeof window === 'undefined') return directoryUrl.toString();
+
+    const instanceUrl = new URL(window.location.href);
+    instanceUrl.search = '';
+    instanceUrl.hash = '';
+    directoryUrl.hash = `!url=${encodeURIComponent(instanceUrl.toString())}`;
+    return directoryUrl.toString();
+  })();
 
   if (hidden) return null;
 
@@ -271,7 +281,7 @@ export function UtilityStrip({
       {isOpen && (
         <div class="utility-strip__items">
           <a
-            href="https://html2rss.github.io/web-application/how-to/use-included-configs/"
+            href={includedFeedsHref}
             target="_blank"
             rel="noopener noreferrer"
             class="utility-link"

From c6eee339680e51d0cb3fbe564373e0aba64acfb4 Mon Sep 17 00:00:00 2001
From: Gil Desmarais <git@desmarais.de>
Date: Sat, 21 Mar 2026 15:37:01 +0100
Subject: [PATCH 2/3] Refine included feed presentation

---
 frontend/src/components/AppPanels.tsx | 26 +++++++-------
 frontend/src/styles/main.css          | 49 +++++++++++++++++++++++++++
 public/shared-ui.css                  |  4 +--
 3 files changed, 65 insertions(+), 14 deletions(-)

diff --git a/frontend/src/components/AppPanels.tsx b/frontend/src/components/AppPanels.tsx
index 19d6f51d..1aaa6582 100644
--- a/frontend/src/components/AppPanels.tsx
+++ b/frontend/src/components/AppPanels.tsx
@@ -152,16 +152,20 @@ export function CreateFeedPanel({
                 role="status"
                 aria-label="Included feeds"
               >
+                <p class="ui-eyebrow">Included feeds</p>
                 <div class="notice__title">Try a working included feed</div>
-                <p>Start with one of the embedded configs from this instance:</p>
-                {featuredFeeds.map((feed) => (
-                  <p key={feed.path}>
-                    <a href={feed.path}>{feed.title}</a>
-                    {' - '}
-                    {feed.description}
-                  </p>
-                ))}
-                <p>
+                <p class="notice__intro">Start with a ready-made feed from this instance.</p>
+                <div class="featured-feed-list" role="list" aria-label="Featured feeds">
+                  {featuredFeeds.map((feed) => (
+                    <div key={feed.path} class="featured-feed-item" role="listitem">
+                      <a href={feed.path} class="featured-feed-item__link" aria-label={feed.title}>
+                        <span class="featured-feed-item__title">{feed.title}</span>
+                        <span class="featured-feed-item__description">{feed.description}</span>
+                      </a>
+                    </div>
+                  ))}
+                </div>
+                <p class="notice__meta">
                   <a
                     href="https://html2rss.github.io/web-application/how-to/use-included-configs/"
                     target="_blank"
@@ -259,9 +263,7 @@ export function UtilityStrip({
     const directoryUrl = new URL('https://html2rss.github.io/feed-directory/');
     if (typeof window === 'undefined') return directoryUrl.toString();
 
-    const instanceUrl = new URL(window.location.href);
-    instanceUrl.search = '';
-    instanceUrl.hash = '';
+    const instanceUrl = new URL('/', window.location.origin);
     directoryUrl.hash = `!url=${encodeURIComponent(instanceUrl.toString())}`;
     return directoryUrl.toString();
   })();
diff --git a/frontend/src/styles/main.css b/frontend/src/styles/main.css
index b245f868..0389addc 100644
--- a/frontend/src/styles/main.css
+++ b/frontend/src/styles/main.css
@@ -345,6 +345,55 @@ a:focus-visible {
   font-weight: var(--text-strong);
 }
 
+.notice__intro,
+.notice__meta {
+  color: var(--text-muted);
+}
+
+.featured-feed-list {
+  display: grid;
+  gap: var(--space-3);
+}
+
+.featured-feed-item {
+  padding: var(--space-3);
+  border: var(--border-default);
+  border-radius: var(--radius-md);
+  background: var(--surface-elevated);
+}
+
+.featured-feed-item__link {
+  display: grid;
+  gap: var(--space-1);
+  transition:
+    border-color var(--transition-fast),
+    background-color var(--transition-fast),
+    transform var(--transition-fast);
+}
+
+.featured-feed-item:hover,
+.featured-feed-item:focus-within {
+  border-color: var(--border-strong);
+  background: rgba(255, 255, 255, 0.065);
+}
+
+.featured-feed-item__link:hover,
+.featured-feed-item__link:focus-visible {
+  text-decoration: none;
+  transform: translateY(-0.04rem);
+}
+
+.featured-feed-item__title {
+  color: var(--text-strong);
+  font-size: var(--font-size-1);
+  font-weight: 600;
+}
+
+.featured-feed-item__description {
+  color: var(--text-muted);
+  line-height: 1.4;
+}
+
 .notice[data-tone="error"] {
   border-color: rgba(248, 113, 113, 0.22);
   background: var(--bg-danger);
diff --git a/public/shared-ui.css b/public/shared-ui.css
index 29145f8d..003588a4 100644
--- a/public/shared-ui.css
+++ b/public/shared-ui.css
@@ -1,8 +1,8 @@
 /* Shared design-system primitives for both the app UI and RSS/XSL surfaces. See docs/design-system.md before changing this file. */
 :root {
   color-scheme: dark;
-  --font-family-ui: "IBM Plex Sans", "Avenir Next", "Segoe UI", sans-serif;
-  --font-family-display: "Fraunces", "Iowan Old Style", "Georgia", serif;
+  --font-family-ui: system-ui, -apple-system, "Segoe UI", sans-serif;
+  --font-family-display: system-ui, -apple-system, "Segoe UI", sans-serif;
   --font-family-mono: "SFMono-Regular", Consolas, "Liberation Mono", monospace;
   --font-size-00: 0.8125rem;
   --font-size-0: 0.9375rem;

From c4a53a84d314dbb10da493d8ca278aebd485fe28 Mon Sep 17 00:00:00 2001
From: Gil Desmarais <git@desmarais.de>
Date: Sat, 21 Mar 2026 15:56:03 +0100
Subject: [PATCH 3/3] style: prettier tsx

---
 frontend/src/components/AppPanels.tsx | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/frontend/src/components/AppPanels.tsx b/frontend/src/components/AppPanels.tsx
index 1aaa6582..cde0cd5a 100644
--- a/frontend/src/components/AppPanels.tsx
+++ b/frontend/src/components/AppPanels.tsx
@@ -282,12 +282,7 @@ export function UtilityStrip({
       </button>
       {isOpen && (
         <div class="utility-strip__items">
-          <a
-            href={includedFeedsHref}
-            target="_blank"
-            rel="noopener noreferrer"
-            class="utility-link"
-          >
+          <a href={includedFeedsHref} target="_blank" rel="noopener noreferrer" class="utility-link">
             Try included feeds
           </a>
           <Bookmarklet />