# SEO rules ## One file owns the head src/layouts/BaseHead.astro writes every meta, canonical, OG, twitter, favicon and feed tag by hand. No SEO package enters this repo; if a tag is missing, add it there, readable and diffable. BaseLayout passes its `title/description/image/type/noindex` props straight through (src/layouts/BaseLayout.astro:31). - Title: `"Title | Brand"` unless the title already carries the brand, which the home page does on purpose (BaseHead.astro:41, src/pages/[...locale]/index.astro:61). - Every page sets a written-for-humans `description`; the site-wide fallback (siteData.description) is for utility pages only. - Canonical: one URL shape, derived from `trailingSlash: "always"` (astro.config.mjs:14) and computed in BaseHead.astro:45-48. File routes (rss.xml, robots.txt) keep their extension. - The single source of the production origin is `site` in astro.config.mjs:10. It feeds canonical, OG, sitemap, robots.txt and llms.txt at once; never hardcode the domain elsewhere. ## JSON-LD: constructors only Structured data is built exclusively with the typed constructors in src/js/schema.ts (`organization` :30, `website` :48, `article` :72, `faqPage` :105, `breadcrumbList` :126, `softwareApplication` :154) and injected through the head slot: ```astro {schemas.map((node) => (