Skip to content

feat(web): head every page with one shared page head - #209

Merged
harenome merged 8 commits into
ThinkFlowLab:mainfrom
harenome:feat/page-head
Nov 18, 2026
Merged

harenome merged 8 commits into
ThinkFlowLab:mainfrom
harenome:feat/page-head

Conversation

@harenome

@harenome harenome commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator

Closes #208

What

Every page title now comes from one macro, page_head(title, sub='', actions='', mark='', mono=false, id='') in templates/_page.html. It writes a <header class="page-head"> with the h1 first, then at most one line under it (sub), then the page's buttons (actions). The styles are in style.css, under "the page head".

Layout. The title is flush left. The line under it holds counts, an id, a badge or pills. The buttons are flush right. Each button is as tall as --tool-h (2.1rem), the table controls' height, and is centred on the title's first line, so the line under the title does not move it. At 640 px and below, the buttons go to their own row under the line, flush left. A mark (a benchmark's or an agent's logo) can go before the title. The h1 has one size on every page (--h1-size). Long titles wrap. The head has one gap under it (--head-gap, 24 px), and the next element adds no margin to it.

Pages. Runs, the empty Runs page, a run, a run being prepared, Launches, Workspaces, the import page, the feasibility check, Classifier vs judge, a comparison, a task side by side, a trial, its attempts, an artifact, the run builder, Recipes, Benchmarks, a benchmark, the Harbor benchmark form, Agents, Capabilities, an agent or a capability, Kits, a kit and Settings.

What moves.

  • A benchmark's tags move from above its title to the line under it. Its logo goes before the title. Its description stays under the head.
  • A run's details are the line under its id. Its buttons are the head's buttons.
  • A trial's outcome and exception are the line under its task. The cards and tabs under it do not change.
  • An agent's, a capability's and a kit's title leave the card and start where other titles start.
  • Settings keeps its Ready to run row under the head.
  • On the two comparison pages, only the title line changes.
  • Sentences that explain a page stay under the head as body text.

Removed text. The builder's sentence ("Choose what to test. Keep every setting explicit.") and the empty Runs page's tagline are gone. The Agents and Capabilities line keeps only the count.

Removed styles. .page-title and its variants (runs-head, ws-head, rcp-head, compare-title, trial-title), .run-header and .run-actions, .bench-index-head, .bench-count, .bench-head and .bench-head-tools, .bench-tags, .bench-actions, .std-head, .std-tags, .start-title, .start-count, .start-head, .st-head, the builder's .nb-heading rules, every page's own h1 size, and .page-title + .alert.

--tool-h. It moves from .table-controls to :root, so the head's buttons and the table controls read one definition.

Fix. A long path in a .subtitle now wraps. Before, it scrolled the Harbor benchmark form sideways at 390 px.

Touches

templates and static (_page.html, 23 page templates, catalogue/use_bundle.html, style.css, catalogue/catalogue.css, builder/command-builder.css, builder/recipes.css, compare/comparison.css, runs/launches.css, runs/start.css, settings/settings.css, settings/modal.css, traces/conversation.css, workspaces/workspaces.css) · route tests

Before and after

Seeded data: a test profile with four workspaces of fixture runs, the route test's fixture job twice, and a run not written yet. Before is main, after is this branch, same URL and width.

Before After
Runs, 1280 px, light before-runs-1280-light after-runs-1280-light
A benchmark, 1280 px, light before-benchmark-1280-light after-benchmark-1280-light
A benchmark, 390 px, dark before-benchmark-390-dark after-benchmark-390-dark
A run, 1280 px, light before-job-1280-light after-job-1280-light
A run, 390 px, dark before-job-390-dark after-job-390-dark
A trial, 1280 px, light before-trial-1280-light after-trial-1280-light
An agent, 1280 px, light before-agent-1280-light after-agent-1280-light
A comparison, 1280 px, light before-compare-1280-light after-compare-1280-light
The run builder, 1280 px, light before-builder-1280-light after-builder-1280-light

Verified

In a throwaway rootless python:3.12 container with Node.js and uv, on a copy of the branch:

  • python3 app/tests/parallel.py: 2249 tests in 127 modules, OK.
  • pip install -r app/requirements.txt, then python3 app/tests/parallel.py app/ui_tests: 638 tests in 53 modules, OK.
  • New in test_every_route.py: every GET route, the trial tabs, the comparison pages and the empty Runs page must have exactly one h1, first in <header class="page-head">.

Browser check, Chromium (Playwright 1.49.1), on the seeded data. 26 pages at 1280 px light and 390 px dark, before and after. The script measures and asserts these results:

  • The h1 size before: 20 to 36 px at 1280 px, 20 to 30 px at 390 px. After: 32 px at 1280 px and 28 px at 390 px on every page.
  • 30 page buttons, each 33.59 px tall, equal to --tool-h and to the table controls' buttons. At 1280 px each button's centre is 0 px from the title's first line.
  • The gap under the head is 24 px on all 52 shots.
  • Nothing sits above the h1 in the head. No title is cut. No page JavaScript error.
  • No sideways scroll at 390 px. Before, the Harbor benchmark form scrolled 70 px.

Not checked: a touch screen (there, --tool-h is 2.75rem in the head), other browsers and a screen reader.

Risk

  • Every page's top changes, so a style or a test that reads an old head class no longer finds it. The suites found and updated five route tests.
  • --tool-h now lives on :root. A page that sets it on another element changes the head's buttons or the table controls there too.
  • Two pages put the head in a column with a gap (the empty Runs page and Settings). Their styles subtract that gap so the head's gap stays 24 px. A change to those gaps must change the subtraction too.
  • "Use bundled entry" opens in place in the buttons' area, so while it is open the title has less width.
  • To undo, revert the branch's commits. No stored data changes.

A title flush left, one line under it, the page's buttons right of the
title's first line at the table controls' height (--tool-h), and one gap
under it.
Runs, the empty Runs page, a run, a run being prepared, Launches, the
feasibility check, Classifier vs judge, the import page and Workspaces.
A run's details are the line under its id and its buttons sit right of
it. The empty Runs page loses its tagline.
Benchmarks, a benchmark, its Harbor form, Agents, Capabilities, an agent
or a capability, Kits and a kit. A benchmark's tags move from above its
title to the line under it, its logo before the title; an agent's and a
kit's title leaves its card. The Agents and Capabilities count drops its
protocol notes.
The builder's title takes the one h1 size and loses its sentence; its
recipe buttons take the page head's height.
Only the title line changes: a comparison and one task side by side.
…ith the page head

A trial's outcome and exception are the line under its task. Only the
title moves: the cards, tabs and Settings' Ready to run stay as they
are.
The page-title row, the run header and its actions, and the gap patch
under a title that the head's one gap now gives.
@harenome
harenome merged commit db89bfb into ThinkFlowLab:main Nov 18, 2026
2 checks passed
@harenome
harenome deleted the feat/page-head branch November 18, 2026 14:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Give every page title one shared page head

1 participant