site

site es el origen público del sitio ("https://example.com", sin ruta). Es el origen de las URL absolutas que Meeko escribe en el build: las de sitemap.xml, la línea Sitemap: de robots.txt y, con document.seo, <link rel="canonical"> y og:url. Sin site, el build usa MEEKO_PUBLIC_ORIGIN de su entorno.

site se fija en el build y no cambia las comprobaciones de Origin de HTTP y Socket: esas siguen leyendo MEEKO_PUBLIC_ORIGIN o publicOrigin de server/runtime.ts al ejecutarse.

Uso#

// meeko.config.ts
import { defineMeekoConfig } from "@meekojs/meeko/framework";

export default defineMeekoConfig({
  site: "https://example.com",
  sitemap: true,
  robots: true,
  document: { seo: true },
});

Tipo#

readonly site?: string

Opciones#

Resultado#

Con site: "https://example.com":

<!-- sitemap.xml -->
<url><loc>https://example.com/docs/api</loc></url>

# robots.txt
User-agent: *
Allow: /
Sitemap: https://example.com/sitemap.xml

<!-- /docs/api con document.seo -->
<link rel="canonical" href="https://example.com/docs/api">

Ejemplos#

Un origen por entorno#

import { defineMeekoConfig } from "@meekojs/meeko/framework";

export default defineMeekoConfig({
  site: process.env.SITE_URL ?? "https://example.com",
  sitemap: true,
});

SITE_URL=https://staging.example.com npm run build

Sin site, con la variable del build#

MEEKO_PUBLIC_ORIGIN=https://example.com npx meeko build

La misma variable fija después, en producción, el origen de las comprobaciones de Origin.

Errores comunes#

Una URL con ruta#

export default defineMeekoConfig({ site: "https://example.com/blog" });

meeko dev, meeko build, meeko check y meeko routes se detienen con …/meeko.config.ts: site must be an origin without path, query, fragment or credentials, such as "https://example.com". Un sitio bajo una subruta no se admite.

import { defineMeekoConfig } from "@meekojs/meeko/framework";
export default defineMeekoConfig({ site: "https://example.com" });

Un dominio sin esquema#

export default defineMeekoConfig({ site: "example.com" });

…/meeko.config.ts: site must be an absolute URL such as "https://example.com".

import { defineMeekoConfig } from "@meekojs/meeko/framework";
export default defineMeekoConfig({ site: "https://example.com" });

Esperar que site arregle las comprobaciones de Origin#

site: "https://example.com" y la aplicación tras un proxy TLS, sin MEEKO_PUBLIC_ORIGIN al ejecutarse

Las mutaciones (con sesión y, desde 1.8, también sin ella) responden 403 INVALID_ORIGIN: site sólo se usa en el build. El origen de las comprobaciones de seguridad se fija al ejecutarse.

MEEKO_PUBLIC_ORIGIN=https://example.com al arrancar el servidor

Notas#

• Sólo build. Un cambio de site exige volver a construir; no se lee en producción.
• Sin origen. Con sitemap, o con document.seo y canonical u ogUrl, y sin site ni MEEKO_PUBLIC_ORIGIN, meeko build se detiene antes de compilar; robots sin sitemap no lo necesita.

Relacionado#

• sitemapEscribe sitemap.xml en el build con las páginas prerenderizadas, las rutas sin parámetros y, desde 1.7, las URL de sitemapEntries de las rutas dinámicas.
• robotsEscribe robots.txt en el build con las reglas de User-agent asterisco y, con sitemap, la URL absoluta del sitemap.
• documentEl documento HTML común de la aplicación, con el lang de html, las etiquetas de head de todas las páginas, la canónica y Open Graph por página y el prefijo de useId.
• sitemap.xml y robots.txtMeeko como framework full-stack
• Canónica y Open Graph por páginaMeeko como framework full-stack