cmux/web/app/[locale]/docs/getting-started/page.tsx
Lawrence Chen 46589f531c
Fix SEO indexing: hreflang, canonicals, sitemap, trailing slash (#2193)
* Fix SEO indexing: add hreflang, canonicals, sitemap per-locale entries

Google Search Console showed 380 not-indexed vs 86 indexed pages.
Root causes: missing hreflang tags on rendered pages (only in sitemap),
no canonical on homepage, inconsistent canonicals wiping parent hreflang,
sitemap only listing English URLs, trailing slash duplicates, and
_next/static chunks being crawled as pages.

Changes:
- Add buildAlternates() utility for consistent canonical + hreflang
- Add hreflang tags to all pages via alternates.languages in metadata
- Add self-referencing canonical URLs to every page (homepage had none)
- Expand sitemap to emit separate entries for each locale
- Add missing /docs/custom-commands to sitemap
- Remove skipTrailingSlashRedirect to normalize trailing slashes
- Block /_next/ in robots.txt to stop chunk crawling

* Add per-page alternates to docs sub-pages and blog index

Docs sub-pages and blog index only returned title/description in
generateMetadata, so they inherited the parent layout's alternates
(pointing to /docs or /blog). Now each page sets its own
buildAlternates() with the correct path so canonical and hreflang
point to the actual page URL.

* Derive openGraph.url from buildAlternates to avoid drift

* Redirect non-English legal pages to English, remove from sitemap

Legal pages (privacy policy, TOS, EULA) are untranslated English content.
Serving them under every locale creates 54 duplicate URLs. Now:
- Middleware 301-redirects /ja/privacy-policy etc. to /privacy-policy
- Sitemap only includes English URLs for legal pages (no locale variants)
- Legal page metadata uses static English-only canonical

* Fix legal page redirect to only match /<locale>/<page> paths

endsWith matched too broadly (e.g. /docs/eula). Now only redirects
when the path after the first segment is an exact legal page match.

* Skip next-intl for legal pages to prevent locale redirect loop

Without this, a Japanese user hitting /privacy-policy could be
redirected by next-intl to /ja/privacy-policy, which our middleware
redirects back to /privacy-policy, creating a loop.

* Rewrite legal pages to /en/ instead of NextResponse.next()

Pages live under app/[locale]/, so skipping next-intl entirely
would break route resolution. Rewrite to /en/privacy-policy etc.
so Next.js can resolve the [locale] segment correctly.

---------

Co-authored-by: Lawrence Chen <lawrencecchen@users.noreply.github.com>
2026-03-26 15:10:39 -07:00

81 lines
2.4 KiB
TypeScript

import { useTranslations } from "next-intl";
import { getTranslations } from "next-intl/server";
import { buildAlternates } from "../../../../i18n/seo";
import { CodeBlock } from "../../components/code-block";
import { Callout } from "../../components/callout";
import { DownloadButton } from "../../components/download-button";
export async function generateMetadata({ params }: { params: Promise<{ locale: string }> }) {
const { locale } = await params;
const t = await getTranslations({ locale, namespace: "docs.gettingStarted" });
return {
title: t("metaTitle"),
description: t("metaDescription"),
alternates: buildAlternates(locale, "/docs/getting-started"),
};
}
export default function GettingStartedPage() {
const t = useTranslations("docs.gettingStarted");
return (
<>
<h1>{t("title")}</h1>
<p>{t("intro")}</p>
<h2>{t("install")}</h2>
<h3>{t("dmgRecommended")}</h3>
<div className="my-4">
<DownloadButton />
</div>
<p>{t("dmgDesc")}</p>
<h3>{t("homebrew")}</h3>
<CodeBlock lang="bash">{`brew tap manaflow-ai/cmux
brew install --cask cmux`}</CodeBlock>
<p>{t("updateLater")}</p>
<CodeBlock lang="bash">{`brew upgrade --cask cmux`}</CodeBlock>
<Callout>
{t.rich("firstLaunchCallout", {
strong: (chunks) => <strong>{chunks}</strong>,
})}
</Callout>
<h2>{t("verifyTitle")}</h2>
<p>{t("verifyDesc")}</p>
<ul>
<li>{t("verifyItem1")}</li>
<li>{t("verifyItem2")}</li>
<li>{t("verifyItem3")}</li>
</ul>
<h2>{t("cliSetup")}</h2>
<p>{t("cliDesc")}</p>
<CodeBlock lang="bash">{`sudo ln -sf "/Applications/cmux.app/Contents/Resources/bin/cmux" /usr/local/bin/cmux`}</CodeBlock>
<p>{t("cliThen")}</p>
<CodeBlock lang="bash">{`cmux list-workspaces
cmux notify --title "Build Complete" --body "Your build finished"`}</CodeBlock>
<h2>{t("autoUpdates")}</h2>
<p>{t("autoUpdatesDesc")}</p>
<h2>{t("sessionRestore")}</h2>
<p>{t("sessionRestoreDesc")}</p>
<ul>
<li>{t("sessionItem1")}</li>
<li>{t("sessionItem2")}</li>
<li>{t("sessionItem3")}</li>
<li>{t("sessionItem4")}</li>
</ul>
<Callout>{t("sessionCallout")}</Callout>
<h2>{t("requirements")}</h2>
<ul>
<li>{t("reqItem1")}</li>
<li>{t("reqItem2")}</li>
</ul>
</>
);
}