Built-in SEO for documentation sites — sitemap, robots, llms.txt, per-page meta tags, and crawlable static HTML.
Top-level seo block in aiui.template.yaml:
seo
aiui.template.yaml
siteUrl is required for absolute canonical URLs, sitemap, and social tags.
siteUrl
aiui build automatically generates:
aiui build
| File | Purpose |
|------|---------|
| sitemap.xml | All doc URLs with lastmod dates |
sitemap.xml
lastmod
| robots.txt | Crawl rules + sitemap pointer |
robots.txt
| llms.txt | AI crawler index (llmstxt.org) |
llms.txt
| llms-full.txt | Full markdown export for AI tools |
llms-full.txt
| docs/**/*.html | Per-route HTML with meta tags + crawl nav |
docs/**/*.html
| .nojekyll | GitHub Pages Jekyll bypass |
.nojekyll
No extra flags are needed — SEO files are emitted whenever content.docs is configured.
content.docs
Use frontmatter on any markdown page:
If description is omitted, the first paragraph is used automatically.
description
Each route HTML file contains:
<link rel="canonical">
<meta name="description">
og:title
og:description
og:url
og:type
og:image
TechArticle
<nav>
<noscript>
When users navigate via the sidebar, React updates title, canonical, OG, Twitter, robots, and JSON-LD to match the current page.
GitHub Pages deploy runs via the Deploy Docs workflow on every push to main. Submit your sitemap in Google Search Console:
main