Skip to content

feat: surface blog posts higher on landing page (one approach — thoughts?)#20

Draft
planetf1 wants to merge 10 commits intogenerative-computing:mainfrom
planetf1:feat/surface-blogs-remove-feature-strip
Draft

feat: surface blog posts higher on landing page (one approach — thoughts?)#20
planetf1 wants to merge 10 commits intogenerative-computing:mainfrom
planetf1:feat/surface-blogs-remove-feature-strip

Conversation

@planetf1
Copy link
Copy Markdown
Collaborator

@planetf1 planetf1 commented Apr 22, 2026

What is this?

One approach to making the landing page feel less static and surfacing recent content earlier. Opening as a draft to get feedback on the layout choices before merging.

Changes

  • Feature strip removed — the four items (Unit testable / 100% Open source / Typed / Any LLM) are already covered by the hero text, the eyebrow label, and the feature cards lower down.
  • Blog cards moved up — the three most recent posts now appear directly below the hero, before "How it works". Visitors see real content before the technical deep-dive.
  • GitHub stats + install command side-by-side — both are developer-detail items; placing them together as a two-tile row below the blog cards keeps them visible without cluttering the hero.
  • Hero simplified — removed the install command from the hero. The hero is now pure messaging: eyebrow + headline + subtitle + logo.
  • Minor spacing tightened — hero padding reduced, gap between hero and blog cards narrowed.

Questions

  • Is the hero too sparse now that the install command is gone from it?
  • Should the blog tiles be a different size or show more/less content?
  • Is the two-tile row (stats + install) the right grouping, or should install live elsewhere?
  • Is there anything in the "How it works" section that could also be trimmed to tighten the overall vertical rhythm?

Screenshot

Screenshot 2026-04-22 at 15 44 03

Note for reviewers: to preview locally — npm run dev at http://localhost:4000

Closes #19

Feature strip (Unit/100%/Typed/Any) is redundant with the hero text and
feature cards. Removing it saves vertical space near the top of the page.

Blog section moved above "See it in action" so recent posts are visible
before the code deep-dive, matching the issue generative-computing#19 proposal.

Assisted-by: Claude Code
@planetf1 planetf1 requested a review from a team as a code owner April 22, 2026 14:00
Blog grid now appears immediately after the hero section (before
How it works), with the GitHub stats widget anchored below the
cards — matching the intended layout from issue generative-computing#19.

Assisted-by: Claude Code
- InstallCommand moved from hero to below GitHub stats in the blog
  section — visitors read content before seeing the install CTA
- Hero padding reduced (6rem/5rem → 3.5rem/2.5rem)
- Logo shrunk (max 420px → 280px, mobile 220px → 180px)
- hero-subtitle margin-bottom cleared (nothing follows it in hero now)

Assisted-by: Claude Code
- Drop 'From the blog' heading and 'All posts →' link — redundant
  with the Blog nav link in the header
- Reduce top padding on blog section (4rem → 1.5rem) to close the
  gap between hero and first blog card
- Add 1.5rem separator between blog grid and GitHub stats widget

Assisted-by: Claude Code
Remove 'Get Started' and 'Read the blog' buttons — both destinations
are already reachable from the nav. Install command is now just the
pill with version badge and copy button.

Wrap InstallCommand in a block-level div with explicit margin-top to
prevent the inline-flex line-height gap above it.

Assisted-by: Claude Code
… padding

useGitHubStats was not checking r.ok on the repo fetch — a 403 rate-limit
response was parsed as JSON and repo.stargazers_count came back undefined,
coercing to 0 via the ?? fallback. Now throws on non-ok so the error
state is set and '—' is displayed.

Also reduce blog section paddingBottom (4rem → 2rem) to close the grey
space below the install command.

Assisted-by: Claude Code
Standalone install pill below GitHub stats looked orphaned.
Hero is the natural home for an install CTA — subtitle leads
directly into it. Restore hero-subtitle margin-bottom to 1.5rem.

Assisted-by: Claude Code
Move InstallCommand out of the hero into a two-tile row next to
GitHubStats — both are developer-detail elements and belong together.
Hero is now pure messaging: eyebrow + title + subtitle + logo.

On mobile the row stacks vertically. Install tile matches the stats
card border style and includes an 'Install' label for context.

Assisted-by: Claude Code
@planetf1 planetf1 marked this pull request as draft April 22, 2026 14:46
@planetf1 planetf1 changed the title feat: surface blog posts higher, remove feature strip feat: surface blog posts higher on landing page (one approach — thoughts?) Apr 22, 2026
@planetf1 planetf1 requested a review from serjikibm April 22, 2026 14:50
- 'Get Started' CTA moved from hero to nav header — update selector
  to page.getByRole('banner') scope
- GitHub stats moved out of hero — remove hero scoping from stats test
- Feature strip removed — delete feature strip test entirely
- 'From the blog' heading removed — drop that assertion from blog test

Assisted-by: Claude Code
@serjikibm
Copy link
Copy Markdown
Collaborator

Is the proposal that we do not have a separate news/highlight section, backed by dedicated content (e.g., 3 predefined md files, that when updated the highlights update), but instead move up the latest blog posts and make them the highlights?

What if we want to call attention to an event, a new release, a new major capability... it'll be nice to have a way to call attention to things other than blogs.

@planetf1
Copy link
Copy Markdown
Collaborator Author

@serjikibm Correct - it's a simple proposal, partly as otherwise I wonder if we'll be wondering how to categorize what content.

Alternatives could include

  • ability to mark posts as sticky
  • rather than 'blog' posts just call everything 'posts' (same infra/authoring) but add a category or trait that we can then select on in different views

But it really came down to - they're all items we want someone to read. a new release? A reference to a third party post? something we write? Do you have specific examples where you think it is sufficiently different?

@psschwei
Copy link
Copy Markdown
Member

I left comments on the issue, but I'll paraphrase here

  • I like the idea of moving the "key" items higher up the screen (they should be "above the fold")
  • github box next to the install box looks too "boxy"
  • I wonder if just swapping the key items and the github info would be the easiest change (?)

@ajbozarth
Copy link
Copy Markdown
Contributor

Feature strip removed
Blog cards moved up

I like these

Is the hero too sparse now that the install command is gone from it?

it LGTM

Should the blog tiles be a different size or show more/less content?

I like the idea of moving the blog section up, but I think we leave the "header" in that specifys them as blog posts and links to the blog (I don't see it in the screenshot), maybe it should stay the way it is but just move above how it works

Is the two-tile row (stats + install) the right grouping, or should install live elsewhere?

I like the idea, but the install card looks weird with the copiable command just in the middle of an empty card

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.

Highlight new/important content

4 participants