SEO

Curvea Engine can generate SEO metadata when the SEO project feature is enabled.

Enable SEO

npx curvea add seo

This sets curvea.features.seo in package.json.

Page metadata

Use one @seo block in a page:

@page

@seo
title = "About Curvea"
description = "A static-first web engine."
image = "/og.jpg"
@end

Supported fields are:

title
description
canonical
image
robots
type

Fallbacks

Curvea Engine resolves fields in this order:

• title: @seo title → page.title → site.name
• description: @seo description → page.description → page.excerpt → site.description
• canonical: @seo canonical → page.route → current route
• image: @seo image → page.image → page.cover → site.image
• robots defaults to index, follow
• type defaults to website

Generated output

When enabled, Curvea Engine can generate the document title, description, canonical URL, robots metadata, Open Graph metadata, and Twitter card metadata.

Existing extracted page <title> markup is removed before Curvea Engine adds the resolved SEO title.

Canonical and image paths are converted to absolute URLs with site.url and site.basePath when possible.