Skip to content

feat(river): reviewer-driven polish (CTA, alpha box, discoverability)#63

Merged
sanity merged 1 commit into
mainfrom
feat/river-landing-polish
Jul 3, 2026
Merged

feat(river): reviewer-driven polish (CTA, alpha box, discoverability)#63
sanity merged 1 commit into
mainfrom
feat/river-landing-polish

Conversation

@sanity

@sanity sanity commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #62, applying two rounds of external review feedback on the live /river page.

Changes

  • CTA: Try RiverInstall Freenet & Join River on all three primary buttons. Two independent reviewers flagged that "Try River" hides the fact the next step installs Freenet. New wording is honest about the install without the "invite" gatekeeping tone we'd removed earlier. Also adds a hero line pulling the install expectation + "the developers are in the room" proof up near the top.
  • Alpha honesty: new "Where River is today" box (Works today / Still alpha). Puts the diagnostic-telemetry disclosure, the metadata caveat, and "not for sensitive comms yet" on the landing page itself rather than only on quickstart. For a privacy audience, disclosing telemetry before the click is the honest move.
  • Signal comparison: split the old "Discord, Signal" row so Signal gets credit for its message encryption, while keeping the architectural point (a company still runs its servers and wants a phone number). Avoids implying Signal reads messages.
  • "Invitation-tree moderation" reworded from jargon into a plain-language benefit.
  • Join step 2 now reassures the official-room invite needs no friend (defuses "invite-only = I'm locked out").
  • Bug: the <title>/og:title still said "group chat with no servers" after the H1 changed to "no company in the middle"; fixed. Dropped an "encrypted" overclaim from the meta description.
  • Homepage discoverability: River is now linked from the "For Users" section and the secondary-links row. It was previously only reachable via the Apps nav dropdown.

Deliberately not done

  • Property comparison table (reviewer suggestion): kept the prose comparison per Ian; the reviewer's table also included a "persists if creator offline?" row that's a non-differentiator we'd already cut.
  • Better hero screenshot: a crop of the current dense capture only gives marginal legibility; the real fix is a fresh narrow-viewport capture of River, which I'll do separately rather than ship a worse crop.

Testing

hugo --gc --minify builds clean. Verified light/dark + desktop/mobile; the long CTA and the two-column status box both behave on mobile.

Draft pending review before deploy.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YRnnQnrtAVHdKzHKT8JrQ6

[AI-assisted - Claude]

…ity)

Applies two rounds of external review feedback:

- CTA: "Try River" -> "Install Freenet & Join River" on all three primary
  buttons, so the button sets the install expectation and doesn't read as
  instant. Adds a hero line ("install a Freenet peer once, then join the live
  official room in your browser, where the developers hang out") pulling the
  install-expectation and the developers-in-the-room proof up to the hero.
- Alpha honesty: new "Where River is today" box (Works today / Still alpha)
  that discloses diagnostic telemetry, the metadata caveat, and "not for
  sensitive comms yet" on the landing page itself, not just quickstart.
- Signal comparison: split Discord/Signal so Signal is credited for its
  message encryption while keeping the architectural point (a company still
  runs its servers and wants a phone number).
- "Invitation-tree moderation" reworded into plain-language benefit.
- Join step 2 reassures the official-room invite needs no friend.
- Fix stale <title>/og:title (still said "no servers") to match the "no
  company in the middle" headline; drop "encrypted" overclaim from the meta
  description.
- Homepage discoverability: link River from the "For Users" section and the
  secondary-links row (previously only reachable via the Apps nav dropdown).

Deferred: a better hero screenshot needs a fresh narrow-viewport capture, not
a crop of the current dense shot; doing that separately.

[AI-assisted - Claude]

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YRnnQnrtAVHdKzHKT8JrQ6
@sanity sanity marked this pull request as ready for review July 3, 2026 21:30
@sanity sanity merged commit d8cbc06 into main Jul 3, 2026
3 checks passed
@sanity sanity deleted the feat/river-landing-polish branch July 3, 2026 21:31
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