meeko prerender

meeko prerender importa el servidor de .meeko/output/node/index.mjs, lo crea con prerendering: true y renderiza cada URL de las rutas render: "prerender" (con prerenderEntries en las dinámicas). Borra y vuelve a escribir .meeko/output/node/prerender/: el HTML de cada página, su payload de navegación (index.meeko.json) y el índice manifest.json. Imprime la ruta de cada HTML escrito.

meeko build ya prerenderiza; este comando sirve para regenerar las páginas cuando cambian los datos que leen sus loaders, sin volver a compilar el cliente ni el servidor.

Uso#

meeko build .
meeko prerender .

C:\proyectos\tienda\.meeko\output\node\prerender\index.html

Tipo#

meeko prerender <directorio>

Parámetros#

Los loaders se ejecutan en este proceso: leen process.env tal como esté al ejecutar el comando (la CLI no lee el .env del proyecto en prerender).

Resultado#

• .meeko/output/node/prerender/<ruta>/index.html y <ruta>/index.meeko.json por página, y manifest.json con el archivo, el ETag, el desplazamiento del <head> y los hashes de los scripts y estilos en línea de cada una, con los que el servidor completa la CSP de esas páginas (con server.contentSecurityPolicy, desde 1.7).
• Una línea por HTML escrito en la salida estándar. Código 0, o 1 con el error si una página falla.

El servidor que está en marcha lee el índice al arrancar y guarda en memoria cada página la primera vez que la sirve: tras meeko prerender, reinicia meeko start para que sirva las nuevas.

Ejemplos#

Regenerar el blog cada noche#

# cron, en el servidor
cd /srv/blog && npx meeko prerender . && systemctl restart blog

// app/pages/blog/[slug].route.ts
import { definePage } from "@meekojs/meeko/framework";

export const route = definePage({
  render: "prerender",
  prerenderEntries: async () => [{ slug: "hola-meeko" }, { slug: "senales" }],
  load: ({ params }) => ({ slug: params.slug ?? "" }),
});

prerenderEntries se evalúa de nuevo, así que un artículo nuevo que devuelva la función aparece sin otro build.

Ver qué rutas se prerenderizan#

meeko prerender . | wc -l

En PowerShell: (meeko prerender .).Count.

Errores comunes#

Sin build de Node#

meeko clean
meeko prerender .

No hay build de producción en C:\proyectos\tienda\.meeko\output\node\index.mjs; ejecuta meeko build

meeko build .
meeko prerender .

Con otro adaptador#

meeko prerender sólo trabaja sobre .meeko/output/node/. Con adapter: "static", bun, deno o cloudflare, el build no escribe esa carpeta (prerenderiza con un servidor intermedio en .meeko/build/node/) y el comando falla igual:

# server: { adapter: "static" }
meeko build .
meeko prerender .

No hay build de producción en …\.meeko\output\node\index.mjs; ejecuta meeko build.

# vuelve a construir: prerenderiza y copia las páginas a la salida del adaptador
meeko build .

Una ruta dinámica sin prerenderEntries#

// app/pages/blog/[slug].route.ts
import { definePage } from "@meekojs/meeko/framework";

export const route = definePage({ render: "prerender" });

Dynamic prerender route /blog/[slug] requires prerenderEntries, también en meeko build.

// app/pages/blog/[slug].route.ts
import { definePage } from "@meekojs/meeko/framework";

export const route = definePage({ render: "prerender", prerenderEntries: [{ slug: "hola-meeko" }] });

Notas#

• Sólo HTML 200. Una página que responde con otro estado, o que no es HTML, detiene el prerender con el error; nada se sirve a medias.
• Middleware. El render no ejecuta el middleware de servidor (server/middleware), que se ejecuta al servir la página; el middleware de ruta sí se ejecuta.
• Sin el sitemap ni los hooks. El comando sólo regenera las páginas: no actualiza sitemap.xml (que está en client/) ni evalúa sitemapEntries. Si cambian las URL, ejecuta meeko build. Los módulos sí reciben el hook prerender:routes.
• Rendimiento. Las URL se renderizan con la aplicación ya construida, sin Vite: es mucho más rápido que un build completo.
• Mensajes. A diferencia del resto de la CLI, el error de build ausente está en inglés.

Relacionado#

• meeko buildComprueba el proyecto y escribe en .meeko/output/<adaptador>/ la salida de producción, con el cliente, el servidor y las páginas prerenderizadas.
• prerenderRoutesPrerenderiza las rutas render "prerender" con un handler de páginas y escribe su HTML, su payload de navegación y el índice manifest.json.
• definePageDeclara las opciones de ruta de una página (schemas de params y search, modo de render, loader, head, layout, middleware, caché y sitemap) con los tipos encadenados entre ellas.
• Modos de renderMeeko como framework full-stack