seo

SEO

Guidelines for search engine optimization across the Grida project -- Next.js pages, blog posts, and documentation.

Scope

Surface	Location	Framework
Marketing / product pages	editor/app/(www)/	Next.js 16
Blog	docs/blog/ or apps/docs/blog/	Docusaurus
Documentation	docs/**	Docusaurus
Sitemaps	editor/app/sitemap.ts + others	Next.js

Next.js Pages (editor/app/(www))

Metadata

Every public page must export metadata (static or dynamic).

// Static
export const metadata: Metadata = {
  title: "Page Title — Grida",
  description: "Concise, keyword-rich description under 160 chars.",
  keywords: ["relevant", "keywords"],
  openGraph: {
    title: "Page Title — Grida",
    description: "Same or tailored OG description.",
    images: ["/og/page-name.png"],
  },
  twitter: {
    card: "summary_large_image",
  },
};

// Dynamic
export async function generateMetadata({ params }): Promise<Metadata> { ... }

Rules:

• title should end with — Grida (or use a title.template in the root layout).
• description must be unique per page, under 160 characters, and include primary keywords.
• Every page with OG images must set metadataBase or use absolute URLs so crawlers resolve them correctly.
• OG images must return 200 without auth and use correct Content-Type.

metadataBase

When openGraph.images uses relative paths, the layout or page must set:

metadataBase: new URL("https://grida.co"),

Without this, crawlers may see broken OG URLs.

Sitemap

Public pages belong in editor/app/sitemap.ts.

{
  url: "https://grida.co/new-page",
  changeFrequency: "monthly",
  priority: 0.5,
}

• Use priority: 1 only for the homepage.
• Match changeFrequency to actual update cadence.
• When adding a new public page, always add a sitemap entry.
• Sitemaps are split per route group (root, /packages, /library, …). A new sitemap.ts is invisible to crawlers until it's added as a Sitemap: line in editor/app/robots.txt — non-root sitemaps are not auto-discovered.
• Prefer deriving sitemap entries from the page's data source (see packages/sitemap.ts) over hand-maintained URL lists, which drift.