Comprehensive SEO & Performance Manual

1. Technical SEO Foundation

A. Dynamic Metadata (TDK)

• Implementation: Managed via site.config.ts and the getMetadata() helper in conjunction with the <SEO /> component.
• Strategy: Every route has a unique Title, Description, and Keyword set.
• AI Enhancement: During the build process, scripts/ai-seo-optimizer.mjs uses Gemini 3 Flash to audit your metadata. It checks for keyword density and generates GEO (Generative Engine Optimization) recommendations stored in docs/ai-seo-audit.json.

B. Authority Guards

• Link Integrity: scripts/check-links.mjs scans the dist/ folder post-build. It flags broken internal links (404s) and identifies images missing alt tags, which are critical for crawler accessibility and ranking.
• Canonicalization: The <SEO /> component automatically generates <link rel="canonical" /> tags to prevent duplicate content issues, especially important for SPA routing. ...