Skip to content

feat(website): add community videos and an agent-review section to the landing page - #610

Open
benvinegar wants to merge 7 commits into
mainfrom
website-landing-depth
Open

feat(website): add community videos and an agent-review section to the landing page#610
benvinegar wants to merge 7 commits into
mainfrom
website-landing-depth

Conversation

@benvinegar

Copy link
Copy Markdown
Member

The landing page asserted that Hunk is review-first and agent-friendly, then asked for an install. Nothing on it showed the agent workflow that justifies the tagline, and the six feature cards were dead ends despite every one of them having a documentation page behind it.

What changed

Community walkthroughs. Two independent videos — Jilles (5:14) and DevOps Toolbox (13:33). Thumbnails are self-hosted webp copies and the cards link out, so no third-party player script loads on a page that otherwise ships zero external JS.

An agent section. The screenshot carries it: a zoomed crop of the graphite theme shot, framed on an agent note and the added lines it annotates. Alongside it, a two-row split answering only "who runs what", and one link into the agent docs.

Feature cards deep-link into the docs. Each of the six now points at the page that teaches it.

A closing call to action and monospace section kickers to give the longer page rhythm.

Notes

  • public/agent-note-zoom.webp is a recrop of the existing shot-graphite.webp, documented in website/MEDIA.md alongside the video thumbnails so both can be refreshed without guesswork.
  • A comparison table against pagers and GUI review tools was built and then removed — it argued a case the screenshots already make. The intermediate commits are left in place rather than rewritten.
  • Website-only, so the changeset is empty.

Verification

  • bun run website:check, bun run website:build, bun run website:links — clean.
  • bun run website:test:browser — 24/24 on desktop and mobile, including axe WCAG-AA on both viewports. Three new tests cover the videos linking out without an iframe, the feature-card documentation links, and the agent section's screenshot and link.

🤖 Generated with Claude Code

@vercel

vercel Bot commented Jul 27, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
hunk-web Ready Ready Preview Jul 27, 2026 6:07pm

Request Review

benvinegar and others added 4 commits July 27, 2026 14:05
The page asserted that Hunk is review-first and agent-friendly, then asked
for an install. Nothing on it answered "why not the diff tool I already
have", showed the agent workflow that justifies the tagline, or gave a
visitor a reason to trust the claims beyond two quotes.

- Community walkthroughs from Jilles and DevOps Toolbox. Thumbnails are
  self-hosted and link out, so no third-party player script loads.
- An agent section that shows the actual session flow beside the notes it
  produces, with pills into the three agent docs pages.
- A positioning section: three stances plus a capability table against
  pagers and GUI review tools.
- Feature cards deep-link into the documentation page that teaches them.
- A documented "works with" list and a closing call to action.

Section kickers and a shared band layout keep the longer page legible.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The support matrix under the install commands restated what the install
list and docs already say, the closing section explained a keystroke
instead of asking for the install, and the comparison buried its table
under three prose cards making the same argument.

- Drop the "works with" definition list.
- Reduce the closing section to one line and the way in.
- Drop the comparison's stance cards and qualifying paragraph; the table
  is the argument.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The agent section explained itself three times over: a lede paragraph, a
five-step command list with a comment above every line, and a caption.
The screenshot underneath it was the weakest part — a full window at
reading-glass size, menus open, showing a human typing a draft note
rather than an agent note rendered in the diff.

- Replace it with a zoomed crop of the graphite theme shot, framed on an
  agent note and the added lines it annotates.
- Drop the lede and the caption; keep the headline.
- Reduce the commands to who runs what, and the links to one.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
"Watch hunk in someone else's terminal" made a visitor decode a metaphor
before knowing a video was on offer, and the paragraph under it argued
for the videos' independence rather than helping anyone choose one.

Every band now leads with a kicker and a headline alone, so the
two-column band head and its lede style are gone with it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@greptile-apps

greptile-apps Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

The landing page gains richer workflow and navigation content.

  • Adds self-hosted community video cards without third-party embeds.
  • Adds an agent-review section with a cropped product screenshot and role-specific commands.
  • Turns six feature cards into documentation links and adds a closing call to action.
  • Adds responsive styling, media-maintenance guidance, and browser tests for the new content.

Confidence Score: 4/5

The incomplete agent-comment command should be corrected before merging because following the landing-page workflow results in a CLI error.

The new page routes, responsive content, and external links are sound, but hunk session comment add --repo . omits required file, summary, and line-target options enforced by the CLI.

Files Needing Attention: website/src/components/marketing/AgentFlow.astro

Important Files Changed

Filename Overview
website/src/components/marketing/AgentFlow.astro Adds the agent workflow presentation, but one displayed command omits required CLI arguments and fails when followed literally.
website/src/components/marketing/CommunityVideos.astro Adds two accessible external video cards using self-hosted thumbnails and appropriately isolated new-tab links.
website/src/pages/index.astro Integrates the new sections, valid documentation deep links, and closing call to action.
website/src/styles/marketing.css Adds responsive card, video, agent-flow, and CTA styling while retaining global keyboard focus treatment.
website/tests/marketing-smoke.spec.ts Covers the new links, assets, agent section, and lack of embedded players, but does not validate that displayed CLI commands parse successfully.
Prompt To Fix All With AI
Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
website/src/components/marketing/AgentFlow.astro:10
**Displayed comment command is incomplete**

When a visitor follows `hunk session comment add --repo .`, the CLI rejects it because `--file`, `--summary`, and exactly one line-target option are required, preventing the advertised workflow from adding an annotation.

Reviews (1): Last reviewed commit: "docs(changeset): describe the shipped la..." | Re-trigger Greptile

{ who: "You", commands: ["hunk diff"] },
{
who: "Your agent",
commands: ["hunk session review --repo . --json", "hunk session comment add --repo ."],

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

P1 Displayed comment command is incomplete

When a visitor follows hunk session comment add --repo ., the CLI rejects it because --file, --summary, and exactly one line-target option are required, preventing the advertised workflow from adding an annotation.

Prompt To Fix With AI
This is a comment left during a code review.
Path: website/src/components/marketing/AgentFlow.astro
Line: 10

Comment:
**Displayed comment command is incomplete**

When a visitor follows `hunk session comment add --repo .`, the CLI rejects it because `--file`, `--summary`, and exactly one line-target option are required, preventing the advertised workflow from adding an annotation.

How can I resolve this? If you propose a fix, please make it concise.

benvinegar and others added 3 commits July 27, 2026 14:06
Ranking Hunk against pagers and GUI review tools argued a case the rest
of the page does not need to make. The screenshots, the walkthroughs, and
the agent section already show what Hunk is; a capability matrix mostly
invited an argument about how each competitor was scored.

Removes the section, its component, its styles, and the header link that
pointed at it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The video and agent sections landed alongside the unified brand shell, so
their two remaining literal colours were the only ones on the page not
reading from the shared palette.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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.

1 participant