astro-i18n-setuplisted

Turn a new-website scaffold into a turnkey multi-language site: Astro i18n routing (clean default locale + prefixed others), self-referencing hreflang + x-default in the Base layout, i18n sitemap alternates, a language switcher, and the test-harness changes that keep the green-from-commit-1 gate honest across locales. Run at scaffold time when new-website Q4 = "two+ languages at launch", OR later to add a second language to a single-locale site whose default stays unprefixed (phased rollout). Trigger phrases: "multi-language site", "add i18n", "DE+EN site", "internationalization", "hreflang setup", "two languages at launch".
karero/website-builder · ★ 4 · Web & Frontend · score 74

Install: claude install-skill karero/website-builder

# Astro i18n setup (scaffold-time, opt-in) Wires turnkey internationalization into the `new-website` Astro overlay. **Opt-in:** the default scaffold stays single-locale. Run it either **at scaffold time** for a 2+-language launch (new-website §1 Q4), **or later** when you add a second language to an existing single-locale site — see **Phased rollout** below. Safe vs unsafe: because the default locale stays **unprefixed** (`/`, not `/en/`), adding a *secondary* prefixed locale (`/de/…`) is purely additive — it never moves an existing URL. What DOES break links/SEO is moving the **default locale itself** off `/` (e.g. retrofitting `/` → `/en/`); this skill never does that, so keep `prefixDefaultLocale: false`. A full re-prefixing of the default is a migration, not this skill. Routing model (house default): **clean default locale, prefixed others** — `/` and `/about` are the default language (marked `x-default`); other languages get a prefix (`/de/`, `/de/about`). `prefixDefaultLocale: false`. This keeps the default-locale URLs identical to a single-locale build, so nothing regresses. Deep SEO rules (reciprocity, x-default, canonical-vs-hreflang, sitemap structure, "translate the whole page not just chrome") live in `seo-audit/references/international-seo.md` — read it, don't re-derive it. ## Phased rollout (primary language first, translate later) You don't have to translate everything before launch. Because the default locale is unprefixed, you can build and ship the **p