Netlify

Netlify lee un pequeño netlify.toml en la raíz de tu proyecto para obtener el comando de compilación y el directorio de publicación. El resto (previsualizaciones de Git, despliegues atómicos, dominios personalizados) se gestiona automáticamente. Netlify también lee el archivo _headers que escribe cada compilación y sirve el 404.html de la compilación para las rutas desconocidas.

Compila el sitio

htmlpress build

La salida queda en .htmlpress/build/.

Configura netlify.toml

[build]
command = "npx gethtmlpress build"
publish = ".htmlpress/build"

Es todo lo que Netlify necesita. El mismo archivo habilita netlify dev en local si alguna vez quieres reproducir el comportamiento del edge de la plataforma.

Despliega con la integración git

El camino recomendado: conecta tu repositorio en app.netlify.com/start. Netlify lee netlify.toml, ejecuta la compilación y publica en producción cada push a main. Las demás ramas y los PR reciben automáticamente URLs de previsualización únicas.

Despliega con la CLI

Para despliegues puntuales o automatizados con scripts:

htmlpress build
netlify deploy --prod --dir=.htmlpress/build

La primera ejecución te pide netlify login y vincula el directorio a un sitio.

Despliega con GitHub Actions

La integración git de Netlify suele bastar, pero un workflow te permite condicionar el despliegue a que pasen los tests:

name: deploy

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: actions/setup-node@v4
        with:
          node-version: 24
      - run: npx gethtmlpress build
      - uses: nwtgck/actions-netlify@v3
        with:
          publish-dir: .htmlpress/build
          production-deploy: true
        env:
          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}

Obtén el token de autenticación en User settings → Applications → Personal access tokens, y el ID del sitio en Site settings → General.

Dominio personalizado

En el panel del sitio, Domain management → Add a domain. Netlify aprovisiona el DNS y un certificado. Define el mismo dominio como site en htmlpress.yaml.

Ver también

• Metadatos del sitio: site rellena las URLs del sitemap.
• Despliegue: volver al índice de hosts.