Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

fix: Dev Tools pages use the shared page header (#13011)

[._.]/ Adam Eivy50ebd7d869e3
diff --git a/client/src/components/Layout.test.jsx b/client/src/components/Layout.test.jsx
index ed7a5e9d57..3398914403 100644
--- a/client/src/components/Layout.test.jsx
+++ b/client/src/components/Layout.test.jsx
@@ -566,7 +566,7 @@ describe('Layout — Game workspace scroll mode', () => {
// tables it nested that scroller inside `<main>`'s own `overflow-auto p-4
// md:p-6` — two scrollbars, doubled padding (#4145).
describe('Layout — Data Manager scroll mode', () => {
- it('gives /data the bare full-width main, and leaves /devtools/datadog padded', async () => {
+ it('gives /data the bare full-width main, and keeps the /datadog redirect route padded', async () => {
const dataManager = await renderLayout('/data');
const dataMain = dataManager.container.querySelector('#main-content');
expect(dataMain?.className).toContain('overflow-clip-safe');
@@ -574,7 +574,7 @@ describe('Layout — Data Manager scroll mode', () => {
expect(dataMain?.className).not.toContain('p-4');
dataManager.unmount();
- const dataDog = await renderLayout('/devtools/datadog');
+ const dataDog = await renderLayout('/datadog');
const dataDogMain = dataDog.container.querySelector('#main-content');
expect(dataDogMain?.className).toContain('overflow-auto');
expect(dataDogMain?.className).toContain('p-4');
@@ -684,7 +684,7 @@ describe('Layout — isFullWidthRoute classification', () => {
['/apps/create', false], ['/apps/create/', false], ['/apps/a1', true], ['/apps/a1/tab', true],
// Data Manager owns its own bar+scroll shell, and is registered EXACT so
// it can't leak onto the DataDog routes that share the `/data` prefix.
- ['/data', true], ['/datadog', false], ['/devtools/datadog', false],
+ ['/data', true], ['/datadog', false], ['/devtools/datadog', true],
// Models owns the same header/tabs/scroll shell as Settings — registered as
// a whole-section prefix, so the bare path and every tab classify alike.
['/models', true], ['/models/performance', true], ['/models/llms', true],
diff --git a/client/src/components/integrations/IntegrationInstancesPage.jsx b/client/src/components/integrations/IntegrationInstancesPage.jsx
index 23b4b1b684..8d487ff8a3 100644
--- a/client/src/components/integrations/IntegrationInstancesPage.jsx
+++ b/client/src/components/integrations/IntegrationInstancesPage.jsx
@@ -2,6 +2,7 @@ import { useEffect, useState } from 'react';
import toast from '../ui/Toast';
import { FormField } from '../ui/FormField';
import PageSkeleton from '../ui/PageSkeleton';
+import PageHeader from '../PageHeader';
import Modal from '../ui/Modal';
import api from '../../services/api';
import { invalidateInstanceFeatures } from '../../hooks/useInstanceFeatures.js';
@@ -9,7 +10,7 @@ import { invalidateInstanceFeatures } from '../../hooks/useInstanceFeatures.js';
const inputClass = 'w-full px-3 py-2 bg-gray-700 border border-gray-600 rounded text-white';
export default function IntegrationInstancesPage({
- title, heading, apiBase, feature, fields, initialForm, summarize, testSuccessDetail,
+ title, icon, apiBase, feature, fields, initialForm, summarize, testSuccessDetail,
helpSteps, headerActions, emptyDescription, deleteDescription, skeletonWidth
}) {
const [instances, setInstances] = useState({});
@@ -135,14 +136,16 @@ export default function IntegrationInstancesPage({
if (loading) return <PageSkeleton label={`Loading ${title}`} padded titleWidthClass={skeletonWidth} cards={2} />;
return (
- <div className="@container/page min-w-0 p-4 sm:p-6">
- <div className="flex flex-wrap justify-between items-center gap-4 mb-6">
- {heading}
- <div className="flex flex-wrap items-center gap-2">
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={icon}
+ title={title}
+ actions={<>
{headerActions}
- {!editingInstance && <button onClick={handleCreate} className="max-w-full w-full @sm/page:w-auto px-4 py-2 bg-port-accent hover:bg-port-accent/80 text-white rounded">+ Add {title} Instance</button>}
- </div>
- </div>
+ {!editingInstance && <button onClick={handleCreate} className="px-4 py-2 bg-port-accent hover:bg-port-accent/80 text-white rounded">+ Add {title} Instance</button>}
+ </>}
+ />
+ <div className="@container/page min-w-0 flex-1 min-h-0 overflow-auto p-4 md:p-6">
<Modal open={!!deleteConfirm} onClose={() => setDeleteConfirm(null)} size="sm" backdropClassName="bg-black/50" ariaLabelledBy={`${feature}-delete-title`}>
<div className="bg-gray-800 rounded-lg p-4 sm:p-6">
@@ -214,6 +217,7 @@ export default function IntegrationInstancesPage({
<div className="space-y-2 text-xs sm:text-sm text-gray-300">{helpSteps}</div>
</div>
</div>
+ </div>
</div>
);
}
diff --git a/client/src/lib/layoutRoutes.js b/client/src/lib/layoutRoutes.js
index a507ad0e4f..ed03d47f58 100644
--- a/client/src/lib/layoutRoutes.js
+++ b/client/src/lib/layoutRoutes.js
@@ -16,6 +16,17 @@ const EXACT_FULL_WIDTH_PATHS = [
// also swallow the `/datadog` redirect route.
'/data',
'/devtools/flows',
+ // Dev Tools pages share one PageHeader bar over a `flex-1 overflow-auto` body (#13011).
+ '/browser',
+ '/uploads',
+ '/security',
+ '/devtools/agents',
+ '/devtools/datadog',
+ '/devtools/history',
+ '/devtools/image-clean',
+ '/devtools/jira',
+ '/devtools/processes',
+ '/devtools/video-download',
'/ask',
// OpenClaw lives under the Settings nav group; it's a full-bleed
// chat surface (sidebar + message pane) that owns its own internal
@@ -126,6 +137,8 @@ const FULL_WIDTH_PATH_PREFIXES = [
'/writers-room',
'/agents',
'/shell/',
+ // GitHub tabs and thread deep links (/devtools/github/:tab/...).
+ '/devtools/github',
'/timeline/',
// Every SongBook route — index (/songbook), import (/songbook/import),
// and viewer (/songbook/:id) — is full-bleed and owns its own scroll
diff --git a/client/src/pages/AgentsPage.jsx b/client/src/pages/AgentsPage.jsx
index 0a0b8370af..ba8b6b6a42 100644
--- a/client/src/pages/AgentsPage.jsx
+++ b/client/src/pages/AgentsPage.jsx
@@ -1,4 +1,5 @@
import { useState, useCallback, useEffect, Fragment } from 'react';
+import PageHeader from '../components/PageHeader';
import { RefreshCw, Activity, XCircle, Cpu, MemoryStick, Terminal } from 'lucide-react';
import * as api from '../services/api';
import { useSocketResource } from '../hooks/useSocketResource';
@@ -56,13 +57,11 @@ export function AgentsPage() {
}
return (
- <div className="space-y-4 lg:space-y-6">
- {/* Header */}
- <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-3">
- <div className="flex items-center gap-2 sm:gap-3">
- <Activity size={24} className="sm:w-7 sm:h-7 text-port-accent-2" />
- <h1 className="text-lg sm:text-2xl font-bold text-white font-mono">AI Agent Processes</h1>
- </div>
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={Cpu}
+ title="AI Agents"
+ actions={<>
<button
onClick={refetch}
className="flex items-center justify-center gap-2 px-3 py-1.5 sm:px-4 sm:py-2 bg-port-card border border-port-border hover:border-gray-500 text-white text-sm rounded-lg transition-colors"
@@ -70,7 +69,10 @@ export function AgentsPage() {
<RefreshCw size={14} className="sm:w-4 sm:h-4" />
<span className="sm:inline">Refresh</span>
</button>
- </div>
+ </>}
+ />
+ <div className="flex-1 min-h-0 overflow-auto p-4 md:p-6">
+ <div className="space-y-4 lg:space-y-6">
{/* Summary Cards */}
<div className="grid grid-cols-3 gap-2 sm:gap-4">
@@ -361,6 +363,8 @@ export function AgentsPage() {
</div>
</div>
</div>
+ </div>
+ </div>
);
}
diff --git a/client/src/pages/Browser.jsx b/client/src/pages/Browser.jsx
index df807d7108..2779329d03 100644
--- a/client/src/pages/Browser.jsx
+++ b/client/src/pages/Browser.jsx
@@ -1,4 +1,5 @@
import { useState, useEffect, useCallback } from 'react';
+import PageHeader from '../components/PageHeader';
import { useSocketResource } from '../hooks/useSocketResource';
import {
Globe, Play, Square, RefreshCw, Settings, Activity,
@@ -152,17 +153,12 @@ export default function BrowserPage() {
const isConnected = status?.connected;
return (
- <div>
- {/* Header */}
- <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-4 mb-6">
- <div>
- <h2 className="text-2xl font-bold text-white flex items-center gap-2">
- <Globe size={28} className="text-port-accent" />
- Browser
- </h2>
- <p className="text-gray-500">Manage the authenticated CDP/Playwright browser</p>
- </div>
- <div className="flex items-center gap-2 flex-wrap shrink-0">
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={Globe}
+ title="Browser"
+ subtitle="Manage the authenticated CDP/Playwright browser"
+ actions={<>
<button
onClick={() => setShowConfig(s => !s)}
className={`flex items-center gap-2 px-3 py-1.5 text-sm rounded-lg transition-colors ${
@@ -193,8 +189,9 @@ export default function BrowserPage() {
<RefreshCw size={16} className={loading ? 'animate-spin' : ''} />
<span>Refresh</span>
</button>
- </div>
- </div>
+ </>}
+ />
+ <div className="flex-1 min-h-0 overflow-auto p-4 md:p-6">
{statusError && (
<p role="alert" className="mb-4 text-sm text-port-error">
@@ -709,6 +706,7 @@ export default function BrowserPage() {
</div>
</div>
</div>
+ </div>
</div>
);
}
diff --git a/client/src/pages/Browser.test.jsx b/client/src/pages/Browser.test.jsx
index a49ddbb1af..a3e126967a 100644
--- a/client/src/pages/Browser.test.jsx
+++ b/client/src/pages/Browser.test.jsx
@@ -41,6 +41,8 @@ describe('Browser recovery', () => {
const user = userEvent.setup();
render(<BrowserPage />);
expect(await screen.findByText('Chrome is not reachable')).toBeInTheDocument();
+ expect(screen.getByRole('heading', { level: 1, name: 'Browser' })).toBeInTheDocument();
+ expect(screen.getByRole('button', { name: 'Edit configuration' })).toBeInTheDocument();
expect(screen.getByText('Health check returned 503')).toBeInTheDocument();
await user.click(screen.getByRole('button', { name: 'Show logs' }));
expect(await screen.findByText('Chrome binary not found')).toBeInTheDocument();
diff --git a/client/src/pages/DataDog.jsx b/client/src/pages/DataDog.jsx
index e0ac09e032..7d9a02b2c8 100644
--- a/client/src/pages/DataDog.jsx
+++ b/client/src/pages/DataDog.jsx
@@ -1,3 +1,4 @@
+import { Dog } from 'lucide-react';
import IntegrationInstancesPage from '../components/integrations/IntegrationInstancesPage';
const SITE_OPTIONS = [
@@ -19,7 +20,7 @@ const initialForm = { id: '', name: '', site: 'api.datadoghq.com', apiKey: '', a
export default function DataDog() {
return <IntegrationInstancesPage
title="DataDog" apiBase="/datadog" feature="datadog" fields={fields} initialForm={initialForm}
- heading={<h1 className="text-xl sm:text-2xl font-bold text-white">DataDog Integration</h1>}
+ icon={Dog}
skeletonWidth="w-56" emptyDescription="Add a DataDog instance to enable error monitoring for your apps."
deleteDescription="This will remove the stored keys."
summarize={instance => <>
diff --git a/client/src/pages/GitHub.jsx b/client/src/pages/GitHub.jsx
index 7c03ae4223..6d200d3c45 100644
--- a/client/src/pages/GitHub.jsx
+++ b/client/src/pages/GitHub.jsx
@@ -1,4 +1,6 @@
import { useParams } from 'react-router';
+import { GitBranch } from 'lucide-react';
+import PageHeader from '../components/PageHeader';
import RouteTabsHeader from '../components/ui/RouteTabsHeader';
import GitHubAccountsTab from '../components/github/GitHubAccountsTab';
import GitHubAuditTab from '../components/github/GitHubAuditTab';
@@ -19,16 +21,19 @@ export default function GitHub() {
const activeTab = GITHUB_PAGE_TABS.some((entry) => entry.id === tab) ? tab : 'inbox';
return (
- <div className="@container/page min-w-0 p-4 sm:p-6">
- <div className="mb-6 flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
- <h1 className="text-xl sm:text-2xl font-bold text-white">GitHub</h1>
- <RouteTabsHeader tabs={GITHUB_PAGE_TABS} activeTab={activeTab} ariaLabel="GitHub views" />
- </div>
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={GitBranch}
+ title="GitHub"
+ actions={<RouteTabsHeader tabs={GITHUB_PAGE_TABS} activeTab={activeTab} ariaLabel="GitHub views" />}
+ />
+ <div className="@container/page min-w-0 flex-1 min-h-0 overflow-auto p-4 md:p-6">
{activeTab === 'inbox' && <GitHubInboxTab />}
{activeTab === 'automations' && <GitHubAutomationsTab />}
{activeTab === 'audit' && <GitHubAuditTab />}
{activeTab === 'repos' && <GitHubReposTab />}
{activeTab === 'accounts' && <GitHubAccountsTab />}
+ </div>
</div>
);
}
diff --git a/client/src/pages/GitHub.test.jsx b/client/src/pages/GitHub.test.jsx
index eb0c0f73b2..1d05a917e7 100644
--- a/client/src/pages/GitHub.test.jsx
+++ b/client/src/pages/GitHub.test.jsx
@@ -95,6 +95,8 @@ describe('GitHub account setup', () => {
const signIn = await screen.findByRole('link', { name: 'Sign in with GitHub' });
expect(decodeURIComponent(signIn.getAttribute('href'))).toContain('/shell?cmd=gh auth login');
expect(screen.getByRole('button', { name: 'Sync Repos' })).toBeDisabled();
+ expect(screen.getByRole('heading', { level: 1, name: 'GitHub' })).toBeInTheDocument();
+ expect(screen.getByLabelText('GitHub views')).toBeInTheDocument();
});
it('describes a signed-out legacy cache without rendering a null account', async () => {
diff --git a/client/src/pages/HistoryPage.jsx b/client/src/pages/HistoryPage.jsx
index ba736580e5..1a2698e309 100644
--- a/client/src/pages/HistoryPage.jsx
+++ b/client/src/pages/HistoryPage.jsx
@@ -1,5 +1,6 @@
import { useState, useEffect, useCallback } from 'react';
-import { Trash2 } from 'lucide-react';
+import PageHeader from '../components/PageHeader';
+import { History, Trash2 } from 'lucide-react';
import * as api from '../services/api';
import { formatTime, formatRuntime, formatDateTime } from '../utils/formatters';
import PageSkeleton from '../components/ui/PageSkeleton';
@@ -90,8 +91,13 @@ export function HistoryPage() {
}
return (
- <div className="space-y-6">
- <h1 className="text-2xl font-bold text-white">Action History</h1>
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={History}
+ title="Action History"
+ />
+ <div className="flex-1 min-h-0 overflow-auto p-4 md:p-6">
+ <div className="space-y-6">
{/* Stats */}
{stats && (
@@ -334,6 +340,8 @@ export function HistoryPage() {
)}
</div>
</div>
+ </div>
+ </div>
);
}
diff --git a/client/src/pages/HistoryPage.test.jsx b/client/src/pages/HistoryPage.test.jsx
index fecf66abd7..4d8ee10fa9 100644
--- a/client/src/pages/HistoryPage.test.jsx
+++ b/client/src/pages/HistoryPage.test.jsx
@@ -47,6 +47,7 @@ describe('HistoryPage list resources (#12171)', () => {
const select = await screen.findByLabelText('Filter by action type');
expect(within(select).getByRole('option', { name: 'No actions available' })).toBeInTheDocument();
+ expect(screen.getByRole('heading', { level: 1, name: 'Action History' })).toBeInTheDocument();
expect(screen.queryByRole('alert')).not.toBeInTheDocument();
});
});
diff --git a/client/src/pages/ImageClean.jsx b/client/src/pages/ImageClean.jsx
index 65556482f2..561933b9ee 100644
--- a/client/src/pages/ImageClean.jsx
+++ b/client/src/pages/ImageClean.jsx
@@ -1,4 +1,5 @@
import { useState, useRef, useCallback, useEffect } from 'react';
+import PageHeader from '../components/PageHeader';
import { Eraser, Upload, Download, ShieldCheck, Sparkles, Brush, Square, Undo2, X, Cpu, Zap, Save } from 'lucide-react';
import toast from '../components/ui/Toast';
import FilePickerButton from '../components/ui/FilePickerButton';
@@ -378,29 +379,25 @@ export default function ImageClean() {
];
return (
- <div className="space-y-6">
- <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-2 sm:gap-4">
- <div>
- <h2 className="text-2xl font-bold text-white flex items-center gap-2">
- <Eraser size={24} className="text-port-accent" />
- Image Cleaner
- </h2>
- <p className="text-gray-500 text-sm">
- Composable, opt-in pipeline: strip provenance/identifying metadata and/or reduce AI-generation artifacts.
- </p>
- <p className="text-gray-500 text-xs mt-1">
- <span className="text-port-warning">Note:</span>{' '}
- the metadata and median/sharpen passes do NOT defeat SynthID — gpt-image / Imagen / Gemini renders stay detectable by their
- vendor watermark checkers (e.g.{' '}
- <a href="https://openai.com/synthid" target="_blank" rel="noopener noreferrer" className="text-port-accent hover:underline">
- openai.com/synthid
- </a>
- ), since SynthID is embedded in pixel values and was designed to survive median + sharpen + re-encode. The <strong>diffusion pass</strong>{' '}
- is the only step that perturbs SynthID's carriers — best-effort, and it <em>disrupts</em> rather than guarantees removal (never verified against
- Google's detector).
- </p>
- </div>
- </div>
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={Eraser}
+ title="Image Cleaner"
+ subtitle="Composable, opt-in pipeline: strip provenance/identifying metadata and/or reduce AI-generation artifacts."
+ />
+ <div className="flex-1 min-h-0 overflow-auto p-4 md:p-6">
+ <div className="space-y-6">
+ <p className="text-gray-500 text-xs">
+ <span className="text-port-warning">Note:</span>{' '}
+ the metadata and median/sharpen passes do NOT defeat SynthID — gpt-image / Imagen / Gemini renders stay detectable by their
+ vendor watermark checkers (e.g.{' '}
+ <a href="https://openai.com/synthid" target="_blank" rel="noopener noreferrer" className="text-port-accent hover:underline">
+ openai.com/synthid
+ </a>
+ ), since SynthID is embedded in pixel values and was designed to survive median + sharpen + re-encode. The <strong>diffusion pass</strong>{' '}
+ is the only step that perturbs SynthID's carriers — best-effort, and it <em>disrupts</em> rather than guarantees removal (never verified against
+ Google's detector).
+ </p>
{!original && (
<div
@@ -780,5 +777,7 @@ export default function ImageClean() {
</div>
)}
</div>
+ </div>
+ </div>
);
}
diff --git a/client/src/pages/Jira.jsx b/client/src/pages/Jira.jsx
index 9cbf27bd80..1dec1b4137 100644
--- a/client/src/pages/Jira.jsx
+++ b/client/src/pages/Jira.jsx
@@ -1,4 +1,5 @@
import { Link } from 'react-router';
+import { Ticket } from 'lucide-react';
import IntegrationInstancesPage from '../components/integrations/IntegrationInstancesPage';
// PAT lifetimes vary by Jira edition and token settings. Test is the reliable signal.
@@ -17,7 +18,7 @@ const initialForm = { id: '', name: '', baseUrl: '', email: '', apiToken: '' };
export default function Jira() {
return <IntegrationInstancesPage
title="JIRA" apiBase="/jira" feature="jira" fields={fields} initialForm={initialForm}
- heading={<h1 className="text-xl sm:text-2xl font-bold text-white">JIRA Integration</h1>}
+ icon={Ticket}
skeletonWidth="w-52" emptyDescription="Add a JIRA instance to enable ticket creation for your apps."
deleteDescription="This will not affect existing tickets."
headerActions={<Link to="/devtools/jira/reports" className="px-4 py-2 border border-port-border hover:border-port-accent text-gray-300 hover:text-white rounded text-sm">Status Reports</Link>}
diff --git a/client/src/pages/Jira.test.jsx b/client/src/pages/Jira.test.jsx
index 2f104720b7..24b30325ff 100644
--- a/client/src/pages/Jira.test.jsx
+++ b/client/src/pages/Jira.test.jsx
@@ -60,6 +60,8 @@ describe('Jira page — token age display', () => {
await renderPage();
await screen.findByText('Acme JIRA');
+ expect(screen.getByRole('heading', { level: 1, name: 'JIRA' })).toBeInTheDocument();
+ expect(screen.getByRole('link', { name: 'Status Reports' })).toBeInTheDocument();
expect(screen.queryByText(/Token saved/)).not.toBeInTheDocument();
expect(screen.queryByText(/age unknown/)).not.toBeInTheDocument();
});
diff --git a/client/src/pages/ProcessesPage.jsx b/client/src/pages/ProcessesPage.jsx
index 92b9637b00..2903f2ce51 100644
--- a/client/src/pages/ProcessesPage.jsx
+++ b/client/src/pages/ProcessesPage.jsx
@@ -1,5 +1,6 @@
import { useState, useMemo, useCallback } from 'react';
-import { Save } from 'lucide-react';
+import PageHeader from '../components/PageHeader';
+import { Activity, Save } from 'lucide-react';
import ProcessesTab from '../components/apps/tabs/ProcessesTab';
import toast from '../components/ui/Toast';
import * as api from '../services/api';
@@ -45,9 +46,11 @@ export function ProcessesPage() {
};
return (
- <div className="space-y-6">
- <div className="flex flex-col sm:flex-row justify-between items-start sm:items-center gap-4">
- <h1 className="text-2xl font-bold text-white">PM2 Processes</h1>
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={Activity}
+ title="Processes"
+ actions={<>
<button
onClick={handlePm2Save}
disabled={saving}
@@ -57,7 +60,10 @@ export function ProcessesPage() {
<span className="hidden sm:inline">{saving ? 'Saving...' : 'PM2 Save'}</span>
<span className="sm:hidden">{saving ? '...' : 'Save'}</span>
</button>
- </div>
+ </>}
+ />
+ <div className="flex-1 min-h-0 overflow-auto p-4 md:p-6">
+ <div className="space-y-6">
{appsState === 'error' && (
<ListLoadError what="managed apps" error={appsError} onRetry={retryApps} />
@@ -68,6 +74,8 @@ export function ProcessesPage() {
<ProcessesTab filterFn={isPortOSManaged} />
</div>
+ </div>
+ </div>
);
}
diff --git a/client/src/pages/ProcessesPage.test.jsx b/client/src/pages/ProcessesPage.test.jsx
index 7853488ee2..c2f6ec9a46 100644
--- a/client/src/pages/ProcessesPage.test.jsx
+++ b/client/src/pages/ProcessesPage.test.jsx
@@ -36,6 +36,8 @@ describe('ProcessesPage list resources (#12171)', () => {
expect(screen.queryByRole('alert')).not.toBeInTheDocument();
});
expect(screen.getByTestId('processes-tab')).toBeInTheDocument();
+ expect(screen.getByRole('heading', { level: 1, name: 'Processes' })).toBeInTheDocument();
+ expect(screen.getByRole('button', { name: /PM2 Save/ })).toBeInTheDocument();
});
it('shows empty copy when managed apps list is empty', async () => {
diff --git a/client/src/pages/Security.jsx b/client/src/pages/Security.jsx
index 34efbb6e1c..a66c83da1a 100644
--- a/client/src/pages/Security.jsx
+++ b/client/src/pages/Security.jsx
@@ -1,4 +1,5 @@
import { useState, useRef, useEffect, useCallback } from 'react';
+import PageHeader from '../components/PageHeader';
import { Camera, Mic, MicOff, Video, VideoOff, RefreshCw, Settings, Volume2 } from 'lucide-react';
import api from '../services/api';
import Banner from '../components/ui/Banner';
@@ -358,14 +359,12 @@ export default function Security() {
}, [streaming, startMedia]);
return (
- <div>
- {/* Header */}
- <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-4 mb-6">
- <div>
- <h2 className="text-2xl font-bold text-white">Security</h2>
- <p className="text-gray-500">Turn your PortOS host into a remote security camera and microphone, accessible from your phone over Tailscale</p>
- </div>
- <div className="flex items-center gap-2">
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={Camera}
+ title="Security Camera"
+ subtitle="Turn your PortOS host into a remote security camera and microphone, accessible from your phone over Tailscale"
+ actions={<>
<button
onClick={() => setShowSettings(s => !s)}
className={`flex items-center gap-2 px-3 py-1.5 text-sm rounded-lg transition-colors ${
@@ -377,8 +376,9 @@ export default function Security() {
<Settings size={16} />
<span className="max-sm:sr-only">Settings</span>
</button>
- </div>
- </div>
+ </>}
+ />
+ <div className="flex-1 min-h-0 overflow-auto p-4 md:p-6">
{/* Error display */}
{error && (
@@ -646,6 +646,7 @@ export default function Security() {
</div>
</div>
</div>
+ </div>
</div>
);
}
diff --git a/client/src/pages/Security.test.jsx b/client/src/pages/Security.test.jsx
index 6857941964..c69791db5d 100644
--- a/client/src/pages/Security.test.jsx
+++ b/client/src/pages/Security.test.jsx
@@ -78,6 +78,13 @@ describe('Security monitor iOS audio session', () => {
vi.unstubAllGlobals();
});
+ it('renders its title and settings control in the shared page header', async () => {
+ render(<Security />);
+ await act(async () => {});
+ expect(screen.getByRole('heading', { level: 1, name: 'Security Camera' })).toBeInTheDocument();
+ expect(screen.getByRole('button', { name: 'Settings' })).toBeInTheDocument();
+ });
+
it('claims playback once the monitor graph is live', async () => {
await startMonitor();
expect(sessionType()).toBe('playback');
diff --git a/client/src/pages/Uploads.jsx b/client/src/pages/Uploads.jsx
index 955886514c..83c76150e7 100644
--- a/client/src/pages/Uploads.jsx
+++ b/client/src/pages/Uploads.jsx
@@ -1,4 +1,5 @@
import { useState, useEffect, useCallback } from 'react';
+import PageHeader from '../components/PageHeader';
import { Upload, Trash2, Download, FileText, Image, File, FolderOpen, RefreshCw } from 'lucide-react';
import { useConfirmDelete } from '../hooks/useConfirmDelete';
import ConfirmButtonPair from '../components/ui/ConfirmButtonPair';
@@ -126,18 +127,14 @@ export default function Uploads() {
}
return (
- <div>
- {/* Header */}
- <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-2 sm:gap-4 mb-6">
- <div>
- <h2 className="text-2xl font-bold text-white">File Uploads</h2>
- <p className="text-gray-500 text-sm sm:text-base">
- {stats
- ? `${stats.count} file${stats.count !== 1 ? 's' : ''} (${stats.totalSizeFormatted})`
- : 'Upload totals unavailable'}
- </p>
- </div>
- <div className="flex items-center gap-2">
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={Upload}
+ title="File Uploads"
+ subtitle={stats
+ ? `${stats.count} file${stats.count !== 1 ? 's' : ''} (${stats.totalSizeFormatted})`
+ : 'Upload totals unavailable'}
+ actions={<>
<button
onClick={fetchUploads}
className="flex items-center gap-2 px-3 py-2 bg-port-card border border-port-border rounded-lg text-gray-400 hover:text-white hover:border-port-accent/50 transition-colors"
@@ -165,8 +162,9 @@ export default function Uploads() {
</button>
)
)}
- </div>
- </div>
+ </>}
+ />
+ <div className="flex-1 min-h-0 overflow-auto p-4 md:p-6">
{/* Upload Zone */}
<div
@@ -295,6 +293,7 @@ export default function Uploads() {
</div>
</div>
)}
+ </div>
</div>
);
}
diff --git a/client/src/pages/Uploads.test.jsx b/client/src/pages/Uploads.test.jsx
index 6a6022b47a..97a5b35df0 100644
--- a/client/src/pages/Uploads.test.jsx
+++ b/client/src/pages/Uploads.test.jsx
@@ -27,6 +27,8 @@ describe('Uploads inventory states', () => {
render(<Uploads />);
expect(await screen.findByText('Uploads could not be loaded')).toBeTruthy();
expect(screen.getByText('Upload totals unavailable')).toBeTruthy();
+ expect(screen.getByRole('heading', { level: 1, name: 'File Uploads' })).toBeInTheDocument();
+ expect(screen.getByLabelText('Refresh')).toBeTruthy();
expect(screen.queryByText('No files uploaded yet')).toBeNull();
expect(screen.queryByText(/0 files/)).toBeNull();
diff --git a/client/src/pages/VideoDownloaderPage.jsx b/client/src/pages/VideoDownloaderPage.jsx
index baade27bb1..68ac067f8f 100644
--- a/client/src/pages/VideoDownloaderPage.jsx
+++ b/client/src/pages/VideoDownloaderPage.jsx
@@ -1,4 +1,5 @@
import { useState } from 'react';
+import PageHeader from '../components/PageHeader';
import { Download, Film, Loader2, Trash2, ExternalLink, Video } from 'lucide-react';
import BrailleSpinner from '../components/BrailleSpinner';
import ListLoadError from '../components/ui/ListLoadError';
@@ -50,15 +51,14 @@ export default function VideoDownloaderPage() {
});
return (
- <div className="max-w-4xl mx-auto space-y-6">
- <header>
- <h1 className="text-xl font-semibold flex items-center gap-2">
- <Film size={20} className="text-port-accent" /> Video Downloader
- </h1>
- <p className="text-sm text-gray-400 mt-1">
- Download a full video from a YouTube or x.com/Twitter URL. Downloaded clips also appear in your media gallery.
- </p>
- </header>
+ <div className="flex h-full flex-col">
+ <PageHeader
+ icon={Film}
+ title="Video Downloader"
+ subtitle="Download a full video from a YouTube or x.com/Twitter URL. Downloaded clips also appear in your media gallery."
+ />
+ <div className="flex-1 min-h-0 overflow-auto p-4 md:p-6">
+ <div className="max-w-4xl mx-auto space-y-6">
<YtDlpUpdateCard />
@@ -189,5 +189,7 @@ export default function VideoDownloaderPage() {
)}
</section>
</div>
+ </div>
+ </div>
);
}
diff --git a/client/src/pages/VideoDownloaderPage.test.jsx b/client/src/pages/VideoDownloaderPage.test.jsx
index 23813d4c65..e28e5d3403 100644
--- a/client/src/pages/VideoDownloaderPage.test.jsx
+++ b/client/src/pages/VideoDownloaderPage.test.jsx
@@ -43,6 +43,7 @@ describe('VideoDownloaderPage', () => {
await waitFor(() => expect(screen.getByRole('alert')).toBeInTheDocument());
expect(screen.getByRole('alert')).toHaveTextContent('Could not load downloads — Downloads 500 error');
+ expect(screen.getByRole('heading', { level: 1, name: 'Video Downloader' })).toBeInTheDocument();
expect(screen.getByRole('button', { name: 'Retry' })).toBeInTheDocument();
expect(screen.queryByText('No videos downloaded yet.')).not.toBeInTheDocument();