Generación estática

El paquete @carats/ssg prerenderiza una aplicación de Carats a HTML estático, lo que resulta útil para sitios que no necesitan un servidor en vivo.

El script

Añade el script de compilación estática a package.json. Ejecuta el binario carats-ssg con NODE_ENV=production, así que la misma canalización de compilación produce la salida estática.

{
  "scripts": {
    "build:static": "cross-env NODE_ENV=production carats-ssg"
  }
}

El binario carats-ssg viene del paquete @carats/ssg, y por eso es una dependencia de ejecución y no de desarrollo: la salida prerenderizada es un artefacto de despliegue.

Cuándo usarlo

Contenido que es igual para todas las visitas, como páginas de marketing y documentación.

• Despliegues que solo necesitan una CDN o un alojamiento de archivos.
• Los sitios que aún necesiten datos por petición deberían usar la integración con Express, porque un culet puede depender de la petición.

El binario carats-ssg no trae declaraciones propias de TypeScript; trátalo como una herramienta de línea de comandos y mantén los tipos del framework en @carats/ssr.

Un culet puede leer cookies, cabeceras o la cadena de consulta. Ninguna ruta respaldada por un culet así puede prerenderizarse de forma significativa, porque la salida quedaría congelada con los datos de una visita. Mantén esas rutas en la compilación con SSR, o marca el componente consumidor con { recast: true } y acepta que la salida estática contendrá datos de relleno.