[marcellosso]

Adds a one-sentence definition, a FAQ and an honest comparison page to the site and README, and a technical SEO/GEO pass: richer JSON-LD, <lastmod> in the sitemap, /llms.txt and a smaller social card.

Closes #12
Closes #13
Closes #14

What changed

Definition and FAQ (#12)

• The definition from the issue, word for word, sits in the homepage hero under the platforms line, and in the README under the tagline.
• A FAQ section before "And from the terminal." with the five questions as <h2>s, plus a FAQPage object in structuredData built from the same text.
• The README's ## FAQ has the same questions and answers.
• The text lives in one place, site/src/lib/faq.ts. The homepage, the JSON-LD and llms.txt all read it, and the README sections were generated from it. Platform, WSL 2, first-launch and MIT facts come from the README's Install and First launch sections.

Compare (#13)

• New /compare page on the Base layout, so its title, description and canonical come from the layout. It has a summary table, then one section per alternative (pm2, foreman/overmind/honcho, tmux/tmuxinator, Docker Compose, concurrently, devglow/DevWebUI), each with "where it wins" and "where localhost fits better", and a short "What localhost isn't".
• Claims about other tools are limited to what their own pages say. The devglow and DevWebUI notes were checked against devglow.app and devwebui.lunarwerx.com. The page also states where localhost loses: it has no MCP server yet, and it uses pipes, not a terminal.
• The README's ## How it compares has the same summary table and links to the page. The page is linked from the homepage FAQ and from the footer (Product → Compare), and it's in the sitemap.

Technical pass (#14)

• JSON-LD: alternateName on WebSite and SoftwareApplication, author url and sameAs, and downloadUrl set to the releases URL.
• sitemap.xml: every <url> has an ISO 8601 <lastmod>, the git commit date of the page's sources. If git can't tell (no history or a shallow clone), it falls back to the build time.
• /llms.txt (text/plain): the definition, the FAQ, every docs page, /compare, the changelog, downloads and the source code.
• og.png: 581 KB → 146 KB, still 1280×640, quantized to a 256-colour palette. I compared it side by side with the original and saw no difference.
• Ports H2: "Know who's on :3000. Find which process is using a port." The second sentence is muted.
• robots.txt, canonical tags and noindex are unchanged.

How it was checked

• pnpm build in site/ passes (18 pages).
• In dist/, I checked that:
  • the JSON-LD parses and has the new fields;
  • the FAQ <h2>s come before the command-line section;
  • every sitemap <url> has a <lastmod>;
  • /compare has its own title, description and canonical, and no page has noindex.
• I looked at the homepage and /compare in the dark appearance with headless Chrome.

Left out

• I haven't run the JSON-LD through Google's Rich Results Test or the schema.org validator, since that needs the deployed URL.

[vercel]

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

Project	Deployment	Actions	Updated
localhost-web	Ready	Preview	Oct 23, 2026 2:24am UTC