feat(marketing): plain-language landing + Mac pages, jargon demoted for SEO (#241)#341
Merged
Merged
Conversation
…or SEO (#241) The LANDING_MODE homepage and the /download page led with terms a non-technical reader doesn't know — "speaks ActivityPub", "the Fediverse", "IndieWeb", "federated with Mastodon" — which filter out exactly the audience the product is for. FediHome is a personal site for short posts, articles, photos, video and audio that people can follow from anywhere; the copy now says that first. Landing (LandingShowcase + the headline/subhead config defaults): - New headline "Your own website — that people can actually follow." and a plain subhead, both as defaults (still overridable via LANDING_HEADLINE / LANDING_SUBHEAD or the admin panel). - Feature cards rewritten benefit-first, including an "it works like email" framing for following across services — the one idea that explains federation without naming it. - The technical standards (ActivityPub, WebFinger, RSS, Mastodon, the fediverse, self-hosted, MIT) are consolidated into one "Open by design — no lock-in" section below the fold. It's the no-lock-in proof point AND the SEO home for the terms technical people search, so demoting the jargon doesn't cost discoverability — it just stops it gatekeeping the hero. - The "Completely open source. Written by AI." section is removed (open-source is kept as a benefit in Open by design; the AI-authorship framing, which puts some people off, is gone). Download page: same treatment — a marketing-first title/description, "across the Fediverse"/"boost" swapped for plain wording, keeping the Mac App Store / native menu-bar / notarized keywords for search. Copy-only; no behaviour change. tsc / 690 tests / eslint / build all green. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Repositions the public marketing copy from jargon-first to benefit-first, while keeping the technical search terms crawlable. Copy-only — no behaviour change.
Why
The
LANDING_MODEhomepage and/downloadpage opened with "speaks ActivityPub", "the Fediverse", "IndieWeb", "federated with Mastodon" — four words that each need a Wikipedia trip before the benefit lands. That filters out the exact audience FediHome is for: people who want their own site to share things, who don't know or care what the plumbing is called.What changed
Landing (
LandingShowcase+ the headline/subhead defaults):LANDING_HEADLINE/LANDING_SUBHEADor the admin panel.ActivityPub/WebFinger/RSS/Mastodon/fediverse/self-hosted/MIT— so demoting the jargon out of the hero doesn't cost discoverability, it just stops the jargon gatekeeping the first thing a visitor reads.Download page:
title/description, kept keyword-rich for search (native macOS app,menu bar,Mac App Store,notarized,macOS 14).The SEO trade, explicitly
Technical searchers still land here: the terms they use all appear in real prose in Open by design and the download metadata — just not in the H1/hero. This is the standard "lead with benefit, keep the keywords in honest body copy" pattern, not keyword-stuffing. Nothing dishonest — e.g. the Mac app is described as a FediHome client, not a generic "Mastodon client" it isn't.
Audience note
This tunes fedihome.social, whose visitors are semi-technical (they're going to self-host), so the install/GitHub/open-source half stays. The fully non-technical framing — "we host it, you just write" — belongs on the managed-hosting site and isn't part of this repo.
Verification
npx tsc --noEmitnpx eslint .npx vitest runnpm run buildActivityPub/Mastodon/fediverse/etc. appear only in the Open by design section + a code comment — none in any hero or feature cardThe landing/download pages require a completed setup to render, and the local dev instance isn't set up, so a live
curlwasn't possible here — the copy is static, compiled by the build, and grep-audited for placement. Visual preview belongs on the demo.Rolling out on the demo
npm run update: everything flows through.🤖 Generated with Claude Code