Skip to content

improve the homepage based on feedback#477

Merged
okdistribute merged 8 commits into
mainfrom
rae/homepage-redesign
Jun 19, 2026
Merged

improve the homepage based on feedback#477
okdistribute merged 8 commits into
mainfrom
rae/homepage-redesign

Conversation

@okdistribute

@okdistribute okdistribute commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

A pass over the homepage (src/app/page.jsx) for clarity and polish. Branched off latest main (so it keeps the /services/hosting link and other recently-merged changes).

Hero

  • Subheadings become a checklist (purple SquareCheck markers).
  • Added a readability scrim — a gradient that's opaque under the text and fades to reveal the animated grid behind it (the grid was making the copy hard to read).

Platform strip

  • A centered row of platform logos: Raspberry Pi, Espressif, Linux, Windows, Apple, Android, Cloudflare, AWS, Azure. Monochrome simple-icons (CC0), recolored via CSS mask so they follow the text color in light/dark.

"Reach every device, on any network"

  • Replaces the 3-tab feature scroller (HomeFeatureTabs) with a single section: the cost-savings graphic (OpenSourceIllustration) + a heading/subhead/4-bullet layout.

"How are people using iroh?"

  • Now a 2-column card grid (was confusing full-width rows), logos removed, with a new File Transfer & Sync card. (Its link is a placeholder → https://docs.iroh.computer; needs a real target.)

Deploy, Monitor, Fix

  • Three dense paragraphs → three scannable bullets (Deploy. / Monitor. / Fix.).

Start building

  • Per-language code tabs (Swift / Rust / JavaScript / Kotlin) instead of a single Rust sample. New CodeBlockTabs component; snippets follow the real iroh-ffi APIs.

Lint clean; verified rendering locally.

🤖 Generated with Claude Code

okdistribute and others added 2 commits June 16, 2026 12:13
- CodeBlockTabs renders multiple syntax-highlighted snippets as a tabbed
  CodeGroup (the multi-language version of CodeBlock).
- public/img/platform-logos: monochrome CC0 simple-icons SVGs for Apple,
  Android, AWS, Azure, Cloudflare, Espressif, Linux, Raspberry Pi, and
  Windows, recolored via CSS mask so they follow the text color in light
  and dark mode.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Hero: turn the subheadings into a checklist and add a readability scrim
  so the text stays legible over the animated grid.
- Add a platform logo strip (Raspberry Pi, Espressif, Linux, Windows,
  Apple, Android, Cloudflare, AWS, Azure).
- Replace the 3-tab feature scroller with a single 'Reach every device'
  section built around the cost-savings graphic.
- Render 'How are people using iroh?' as a 2-column card grid and add a
  File Transfer & Sync card.
- Turn 'Deploy, Monitor, Fix' into scannable bullets.
- Start building: show per-language code snippets (Swift, Rust,
  JavaScript, Kotlin) in tabs instead of a single Rust sample.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 16, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
iroh-computer Ready Ready Preview, Comment Jun 19, 2026 12:09am

Request Review

@okdistribute okdistribute changed the title Redesign the homepage improve the homepage based on feedback Jun 16, 2026
@n0bot n0bot Bot added this to iroh Jun 16, 2026
@github-project-automation github-project-automation Bot moved this to 🚑 Needs Triage in iroh Jun 16, 2026
The hero copy lived in an absolutely-positioned container with no width,
so on narrow screens it shrink-wrapped to its content (up to max-w-7xl)
and overflowed instead of wrapping. Let it flow and wrap on mobile, and
keep the exact desktop overlay via md: overrides (md:absolute, md:w-auto,
md:h-[600px]).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Prepend Swift, Rust, JavaScript, and Kotlin (monochrome simple-icons) to
the top strip so it shows both the supported languages and platforms, all
recolored via CSS mask to match. Includes in-progress hero/section copy
tweaks (low-latency framing).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@rklaehn

rklaehn commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

I do like having the platform/language/arch icons first. Maybe we can link the language icons to the relevant package repositories where possible.

I think the "testimonial bar" with black background looks a bit rough. Or is that only in preview?
image

The old "users" scrolling bar was outdated and not clickable, but I think there is some value in having the logos of some of our customers visible somewhere on the front page. They are not big logos, but some of them (nous, delta.chat) do have some name recognition, and we want to show that this is being used in production in multiple segments.

In general the language and platofrm icons are great, but the cloud provider icons don't really make that much sense to me. What is this supposed to mean? Iroh works if put on an ec2 instance? Yeah, sure. But that isn't really that special...
image

@okdistribute

Copy link
Copy Markdown
Contributor Author

@rklaehn thank you!

  1. linked language icons to the relevant docs pages since they are more comprehensive getting started guides, and then also linked to the package repos
  2. removed the 3 cloud provider icons, but this is here because sometimes these tools only work with one provider so was making it clear it's provider agnostic. but maybe we don't need to worry about that for our audience.
  3. logos from customers are not recognizable, I am not sure it's helping as much as the cards that list the use cases (and each use case is highlighting a customer inside it). I'd like to wait until we have some logos from customers that are known
  4. the testimonial background needs a light mode good point

- Drop cloud-provider logos (AWS/Azure/Cloudflare) from the strip
- Link language logos to their docs.iroh.computer/languages pages
- Split languages and platforms onto separate rows
- Give the testimonial section a light-mode variant

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Use full-color language logos for the languages row
- Tint platform icons with their brand colors (Apple stays neutral)
- Reduce the top spacing above the languages row

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
#FCC624 was near-invisible on the light background (1.59:1 contrast);
#B8860B reads clearly in both light and dark.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@b5

b5 commented Jun 18, 2026

Copy link
Copy Markdown
Member

Hero:

  • the visibility scrim is too heavy-handed. Please remove
  • The checklist is too much. Let's replace it with "Add Zero-Trust peer-to-peer connectivity to your app, agent, or workflow", dropping the other two bullet points. It's a smaller change, but I think we'll experiment with swapping some refined version of this language as the main headline next week.

Supported Platforms

  • we are missing Python from the list of supported langauges, both in the list, and in the lower down example code
  • I disagree that swapping the logo farm with the supported platforms is the right call. We need real world use to always land right after the hero
  • But the supported platforms is fantastic. Let's add the words "Works with your language & platform low power to high" (language improvements welcome), and make the support it's own section, coming after the quote section break

Other

  • I disagree that the visual break of the quote section is harsh. The entire page now looks anemic & unopinionated. There is a way to make it less harsh, but this isn't it. Please revert so we cam merge other changes.

Homepage:
- Logo strip: link each logo (new tab), add Mesh LLM / Strada / Ottomatic,
  drop Holochain, muted labels, color language + platform logos
- Reorder sections: real-world logos after hero, supported platforms as its
  own section, quote and "Open source. Forever." dark bands
- Simplify hero copy; remove cloud-provider logos; add Python (strip, "Start
  building" logos, and a Python code tab)

Dark mode:
- Restore the theme toggle (top-right) and stop forcing light site-wide
- Use black backgrounds across header, home, blog, and other page wrappers
- Keep accent bands as dark navy so they read against the black
- Keep the Read the Docs button bright purple

Fixes:
- Register python with shiki so the Python snippet renders
- Blog dark-mode contrast (slate-toned muted text)
- Point Paycode logo at paycode.com.mx

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@okdistribute okdistribute merged commit 2299e07 into main Jun 19, 2026
4 checks passed
@github-project-automation github-project-automation Bot moved this from 🚑 Needs Triage to ✅ Done in iroh Jun 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

3 participants