fix(frontend): restore docker hub menu link and smoke stubs

Author: gildesmarais

frontend/e2e/smoke.spec.ts

@@ -2,13 +2,58 @@ import { expect, test } from '@playwright/test';
 
 test.describe('frontend smoke', () => {
   test('loads create flow and inline access-token gate', async ({ page }) => {
+    await page.route(/\/api\/v1$/, async (route) => {
+      await route.fulfill({
+        status: 200,
+        contentType: 'application/json',
+        body: JSON.stringify({
+          success: true,
+          data: {
+            api: {
+              name: 'html2rss-web API',
+              description: 'RESTful API for converting websites to RSS feeds',
+              openapi_url: 'http://example.test/openapi.yaml',
+            },
+            instance: {
+              feed_creation: {
+                enabled: true,
+                access_token_required: true,
+              },
+              featured_feeds: [],
+            },
+          },
+        }),
+      });
+    });
+
+    await page.route(/\/api\/v1\/strategies$/, async (route) => {
+      await route.fulfill({
+        status: 200,
+        contentType: 'application/json',
+        body: JSON.stringify({
+          success: true,
+          data: {
+            strategies: [
+              { id: 'faraday', name: 'faraday', display_name: 'Default' },
+              {
+                id: 'browserless',
+                name: 'browserless',
+                display_name: 'JavaScript pages (recommended)',
+              },
+            ],
+          },
+          meta: { total: 2 },
+        }),
+      });
+    });
+
     await page.goto('/');
 
-    await expect(page.getByLabel('PAGE URL')).toBeVisible();
+    await expect(page.getByLabel('Page URL')).toBeVisible();
     await expect(page.getByRole('button', { name: 'Generate feed URL' })).toBeVisible();
-    await expect(page.getByRole('button', { name: 'MORE' })).toBeVisible();
+    await expect(page.getByRole('button', { name: 'More' })).toBeVisible();
 
-    await page.getByLabel('PAGE URL').fill('https://example.com/articles');
+    await page.getByLabel('Page URL').fill('https://example.com/articles');
     await page.getByRole('button', { name: 'Generate feed URL' }).click();
 
     await expect(page.getByRole('heading', { name: 'Add access token' })).toBeVisible();
@@ -18,6 +63,6 @@ test.describe('frontend smoke', () => {
 
     await page.getByRole('button', { name: 'Back' }).click();
     await expect(page.getByRole('button', { name: 'Generate feed URL' })).toBeVisible();
-    await expect(page.getByRole('button', { name: 'MORE' })).toBeVisible();
+    await expect(page.getByRole('button', { name: 'More' })).toBeVisible();
   });
 });

frontend/src/__tests__/App.test.tsx

@@ -268,6 +268,36 @@ describe('App', () => {
     expect(mockClearToken).toHaveBeenCalled();
   });
 
+  it('keeps the Docker Hub link before token clear when a token is saved', () => {
+    mockUseAccessToken.mockReturnValue({
+      token: 'saved-token',
+      hasToken: true,
+      saveToken: mockSaveToken,
+      clearToken: mockClearToken,
+      isLoading: false,
+      error: null,
+    });
+
+    render(<App />);
+
+    fireEvent.click(screen.getByRole('button', { name: 'More' }));
+
+    const utilityItems = Array.from(
+      screen
+        .getByLabelText('Utilities')
+        .querySelectorAll('.utility-strip__items > a, .utility-strip__items > button')
+    ).map((element) => element.textContent);
+
+    expect(utilityItems).toEqual([
+      'Try included feeds',
+      'Bookmarklet',
+      'OpenAPI spec',
+      'Source code',
+      'Install from Docker Hub',
+      'Clear saved token',
+    ]);
+  });
+
   it('saves access token and resumes feed creation from the inline prompt', async () => {
     render(<App />);
 
@@ -375,7 +405,13 @@ describe('App', () => {
     fireEvent.click(screen.getByRole('button', { name: 'More' }));
 
     const utilityLinks = screen.getAllByRole('link').map((link) => link.textContent);
-    expect(utilityLinks).toEqual(['Try included feeds', 'Bookmarklet', 'OpenAPI spec', 'Source code']);
+    expect(utilityLinks).toEqual([
+      'Try included feeds',
+      'Bookmarklet',
+      'OpenAPI spec',
+      'Source code',
+      'Install from Docker Hub',
+    ]);
 
     expect(screen.getByRole('link', { name: 'OpenAPI spec' })).toHaveAttribute(
       'href',
@@ -385,5 +421,9 @@ describe('App', () => {
       'href',
       'https://html2rss.github.io/web-application/how-to/use-included-configs/'
     );
+    expect(screen.getByRole('link', { name: 'Install from Docker Hub' })).toHaveAttribute(
+      'href',
+      'https://hub.docker.com/r/html2rss/web'
+    );
   });
 });

frontend/src/components/AppPanels.tsx

@@ -292,6 +292,14 @@ export function UtilityStrip({
           >
             Source code
           </a>
+          <a
+            href="https://hub.docker.com/r/html2rss/web"
+            target="_blank"
+            rel="noopener noreferrer"
+            class="utility-link"
+          >
+            Install from Docker Hub
+          </a>
           {hasAccessToken && (
             <button type="button" class="utility-button" onClick={onClearToken}>
               Clear saved token