Skip to content

feat(docs): an asymmetric hero, and the card names this project - #101

Merged
ajbarea merged 1 commit into
mainfrom
feat/asymmetric-hero
Sep 20, 2026
Merged

ajbarea merged 1 commit into
mainfrom
feat/asymmetric-hero

Conversation

@ajbarea

@ajbarea ajbarea commented Sep 20, 2026

Copy link
Copy Markdown
Owner

The landing page centred its copy because the artwork was square and symmetric, so there was nowhere clean to set a left-aligned column. New art with an empty left third is what unblocks the layout the sister sites use.

The layout

Copy sits left against empty ground; the art anchors right and keeps its braid. Two things are worth calling out because both were mistakes on the way:

The scrim is derived from the copy column, not from a share of the viewport. A gradient stated in percentages cannot track a column sized in rem — that is exactly how ariadne's hero lost the last words of every line (ajbarea/ariadne#46). Here the column and the scrim are both built from --hero-copy-width, so they cannot drift.

The column is stated in vw, not %. Stated as 42% it resolved against the hero's content box rather than the viewport and collapsed the column to 440px, which cramped the wordmark onto two lines and stacked the buttons. 42vw means what it says.

The social card

It read InteFL — Federated learning, under fire — 10 strategies · 6 attacks · Byzantine-robust, over github.com/ajbarea/phalanx-fl. That is a different project's name and figures, and none of the three describes this one. Every unfurl of a Phalanx link has been carrying it. The card now carries this project's name and its actual line, set in Inter, the site's own face.

Weight

was now
dark hero 3.6MB 349KB
light hero 685KB 383KB
social card 784KB 114KB

5MB to 846KB. All three move to JPEG, including the card: the brief had called for PNG on the grounds that JPEG ringing shows on letterforms, but measured against the PNG at q92 the text regions differ by at most 21/255 with under 0.5% of pixels past a delta of 8. Not visible, and 6.6x smaller.

Verification

Built locally and checked at 1440, 1024 and 390, in both schemes:

  • Wordmark, subtitle, buttons and mode strip all sit inside the scrimmed column at every width.
  • Below 960px the layout centres and the veil goes vertical, because a left-anchored falloff cannot work once the copy spans full width.
  • Contrast sampled from the rendered page: subtitle 9.76:1, mode strip 5.70:1 at its right end and 3.87:1 at its left. All past AA for their sizes.
  • zensical build --clean — "No issues found".

README.md and overrides/main.html follow the renamed assets; IMPL.md records what shipped against what the brief asked for.

The art is new: nodes in loose formation, one telemetry trace each, braiding
rightward into a single ribbon, with the left third left empty. That empty
ground is what the layout needed. The copy now sits left against it rather
than centred over a symmetric mandala, so the scrim no longer has to be
dense enough to carry text across the whole frame.

The scrim is derived from the copy column, not from a share of the viewport,
because the two cannot be kept in step by hand -- the sister site's hero lost
the end of every line that way. The column is stated in vw for the same
reason: as a percentage it resolved against the hero's content box and
collapsed to 440px.

The social card no longer reads "InteFL - Federated learning, under fire -
10 strategies, 6 attacks, Byzantine-robust". That is a different project and
none of those figures describe this one; it carries this project's name and
line now, set in the site's own face.

All three assets move to JPEG. Together they were 5MB and are now 846KB.
@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 23:08
@ajbarea
ajbarea merged commit 60fbc6f into main Sep 20, 2026
10 checks passed
@ajbarea
ajbarea deleted the feat/asymmetric-hero branch September 20, 2026 23:09
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