Skip to content

design: homepage critique pass — hero hierarchy, copy voice, panel consistency - #250

Merged
alpergundogdu merged 7 commits into
mainfrom
claude/impeccable-critique-909cc4
Sep 25, 2026
Merged

alpergundogdu merged 7 commits into
mainfrom
claude/impeccable-critique-909cc4

Conversation

@yigitdot

@yigitdot yigitdot commented Sep 24, 2026 •

Copy link
Copy Markdown
Collaborator

What

A design critique of the homepage, and the fixes it led to, split into these commits:

  1. Copy (lib/copy.ts)
    • Hero lead cut from ~90 words to 3 sentences.
    • Body prose is now sentence case with proper nouns (Berlin, BLAKE3, USDC, Gbps, PoP). Display headlines stay lowercase.
    • The method stack is one chip row (Rust · BLAKE3 · QUIC · iroh · USDC · EVM). The METHOD_FIGURES strip, which repeated it, is removed.
    • The Contact section gets a real display heading (CONTACT_HEADLINE) in place of the repeated wordmark, and the link label reads "X".
    • The llms-full.txt mirror and tests follow.
  2. Hero
    • "Read the litepaper" is the single primary CTA (.cta-primary: solid ink with a whisper offset shadow). Docs and source are quieter text links.
    • The terminal aligns to the top of its grid row, so it is fully visible on load at 1440×900.
    • The FAQ meta label said "field notes", which is the blog's name. It now shows the question count.
  3. Panels: .fleet and .faq-card now share the terminal's style: square, dashed border, flat fill. The fleet's hover scale(1.03) on a non-interactive panel is removed, and a stale comment is fixed.
  4. Layout: sections are content height plus fixed padding. The min(100svh, 54rem) floor on Frame, which left viewport-dependent empty space under shorter sections (about 70px under the hero at 1440×900), is removed along with the fill prop.
  5. Motion: scroll reveals travel 24px instead of 72px and finish on the element's own entry (entry 0% entry 70%), so table rows no longer stay dim while being read.

Why

The critique found three main problems:

  • The hero's proof object (the terminal) was below the fold behind a long paragraph.
  • Lowercasing proper nouns made the page harder to scan for a technical audience.
  • The three demo panels had drifted into three different styles.

Reviewer notes

  • The copy changes are a brand-voice call. Headlines stay lowercase; body prose and proper nouns are now standard case. Comparison-table cells stay lowercase fragments, with proper nouns fixed.
  • "chain-agnostic" lived only in the removed figure strip, so it no longer appears on the page.
  • I kept the FAQ ghost ordinal and the per-row reveals on the comparison table. The ghost has a documented purpose, and the table's reveal stagger is tested.
  • The hero keeps its "§ 01 / HERO" label, so the numbered sections still start at § 01.
  • Verified: pnpm typecheck, lint, test (467 passing), format:check, pnpm build (including check:out and check:og-image), and the dev server at 1920×1080, 1440×900 and 375×812. The mobile hero is about 150px shorter, with no horizontal overflow.
  • Not addressed, and there before this PR: on mobile, text shows faintly through the translucent top nav right after scrolling.

🤖 Generated with Claude Code

yigitdot and others added 4 commits September 24, 2026 20:05
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings September 24, 2026 17:06

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 24, 2026 •

Copy link
Copy Markdown

Deploying website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 95f3569
Status: ✅  Deploy successful!
Preview URL: https://3bb417e7.website-70y.pages.dev
Branch Preview URL: https://claude-impeccable-critique-9.website-70y.pages.dev

View logs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
alpergundogdu and others added 2 commits September 25, 2026 10:24
Without it the page's first numbered label was § 02, which read as a
missing section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Frame's min(100svh, 54rem) floor left empty space under any section
shorter than the screen, and how much depended on the viewport height.
Sections are now content height plus the fixed vertical padding.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@alpergundogdu
alpergundogdu merged commit e77cae7 into main Sep 25, 2026
6 checks passed
@alpergundogdu
alpergundogdu deleted the claude/impeccable-critique-909cc4 branch September 25, 2026 09:55
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.

3 participants