Skip to content

docs(impl): record the hero brief, and why the layout waits on it - #99

Merged
ajbarea merged 1 commit into
mainfrom
docs/hero-brief
Sep 20, 2026
Merged

ajbarea merged 1 commit into
mainfrom
docs/hero-brief

Conversation

@ajbarea

@ajbarea ajbarea commented Sep 20, 2026

Copy link
Copy Markdown
Owner

The hero prompt existed only in a chat transcript, which is not somewhere it can be found again. This puts it in IMPL.md with the parts that were missing from it.

The under-specified bit was the aspect ratio. The current heroes are near-square — phalanx-hero.png is 1678x1641 — and a square frame cannot hold an empty left third, so a 1:1 source forecloses a left-aligned column no matter what is drawn in it. background: ... / contain also letterboxes a square image in a wide viewport, which is the banding visible on the page today.

A regeneration needs three files, not one: the dark hero, the light hero, and the 1200x630 OG card that overrides/main.html points at. The note records which stylesheet line reads each.

It also records what changes in extra.css once an asset exists, including the specific trap: the scrim must be measured from the copy column's own edge rather than from a share of the viewport. That is what made ariadne's hero unreadable at 1440px, fixed in ajbarea/ariadne#46, and this layout would otherwise reproduce it.

No code changes.

The landing page centres its copy because the artwork is square and
symmetric. The legibility fix made that copy readable, but a veil dense
enough to carry text also dims the art beneath it, so the real fix is an
image with empty ground to set type on.

Records the prompt, the three files a regeneration has to produce, and the
CSS that changes once one exists. The aspect ratio is the load-bearing
part: a 1:1 source forecloses a left-aligned column whatever is drawn in it.
@ajbarea ajbarea added the documentation Improvements or additions to documentation label Sep 20, 2026
@ajbarea ajbarea self-assigned this Sep 20, 2026
@ajbarea
ajbarea enabled auto-merge (squash) September 20, 2026 18:50
@ajbarea
ajbarea merged commit 0cdba41 into main Sep 20, 2026
10 checks passed
@ajbarea
ajbarea deleted the docs/hero-brief branch September 20, 2026 18:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant