Documentación

Guía de publicación

Una guía práctica para convertir archivos locales en un enlace HTTPS, preparar builds estáticos, conectar dominios y actualizar proyectos en DeployPages.

Inicio rápido

Publicar significa convertir archivos locales en una URL que otras personas pueden abrir. DeployPages está pensado para salida estática, así que el primer sitio puede empezar con una carpeta en lugar de configurar un servidor.

Opción 1: subir una carpeta desde el navegador

Es la ruta más rápida para proyectos estáticos. Si ya tienes HTML, CSS, JavaScript o una carpeta de build terminada, puedes subirla directamente.

Buen uso para

Landing pages, sitios personales, CV en línea, prototipos, documentación estática, archivos HTML y builds front-end listos para navegador.
  • 1
    Prepara la carpeta publicable

    La carpeta debe incluir un index.html en la raíz y los estilos, scripts, imágenes o archivos que la página necesite.

    Estructura de ejemplo
    my-site/├── index.html├── styles.css├── script.js└── images/    ├── logo.png    └── hero.jpg

    Error común

    Si index.html no existe o queda dentro de una subcarpeta, el sitio puede no resolver bien después de subirlo.
  • 2
    Abre el área de carga

    Usa el área de carga de DeployPages. Puedes publicar un proyecto temporal primero y luego iniciar sesión si quieres conservarlo.

  • 3
    Sube la carpeta completa

    Arrastra la carpeta completa o elige los archivos desde el selector. En frameworks, sube la carpeta de salida del build, no el árbol de código fuente.

  • 4
    Abre la URL generada

    Cuando termina la carga, DeployPages devuelve una URL en línea que puedes probar, compartir o usar como vista previa.

Opción 2: flujo con CLI

Sirve cuando el mismo build se publica varias veces y la publicación debe vivir en un script, job de CI o checklist de lanzamiento.

Úsalo cuando el proyecto ya sea repetible

Arrastrar y soltar es mejor para vistas únicas. Un flujo con CLI tiene sentido cuando el equipo necesita publicar la misma carpeta de salida de forma consistente.

Instala la CLI

Usa tu gestor de paquetes preferido para instalar la CLI globalmente.

npm install -g @deploypages/cli

Autentica la sesión

Ejecuta el comando de login y completa la autorización en el navegador.

deploypages login

Publica la carpeta actual

Ejecuta el comando de publicación desde la carpeta de salida del build.

deploypages deploy

Guía de builds por framework

Los frameworks modernos necesitan un paso de build antes de subir archivos. La meta siempre es la misma: generar HTML, CSS, JavaScript y recursos estáticos que el navegador pueda abrir.

Qué significa build

Un build convierte archivos fuente del framework en archivos publicables: HTML, CSS, JavaScript, imágenes y otros recursos.

React / Vue / Vite

Command:npm run build
Output:dist/

Sube la carpeta dist, no la raíz del proyecto.

Exportación estática de Next.js

Command:npm run build
Output:out/

Configura output: 'export' en next.config.js antes de construir.

HTML simple

Command:No requiere build
Output:Tu carpeta actual

Mantén index.html en la raíz.

Hugo / Hexo

Command:hugo o hexo generate
Output:public/

Sube la carpeta public generada.

Ejemplo de exportación en Next.js

next.config.js
/** @type {import('next').NextConfig} */const nextConfig = {  output: 'export',  images: { unoptimized: true },};
module.exports = nextConfig;

Límites de la exportación estática

Funciones renderizadas en servidor, como API routes, server-side props y middleware, no están disponibles en un build exportado como sitio estático.

Dominios personalizados

Después de la primera publicación, DeployPages puede conectar tu propio dominio para mover el proyecto de una URL del sistema a una dirección de marca.

Qué cuenta como dominio

Cualquier dominio que administres desde un registrador puede funcionar, siempre que puedas editar sus registros DNS.

Paso 1: agrega el dominio en el panel

Ve a la configuración del proyecto, abre la sección de dominios y agrega el nombre de host que quieres conectar.

Paso 2: configura DNS

DeployPages te muestra los valores DNS necesarios para verificar propiedad y enrutar tráfico.

Paso 3: espera la verificación

Cuando DNS se propaga, el estado del dominio pasa a saludable y el certificado HTTPS puede terminar de emitirse.

TipoHostValorPropósito
CNAMEwwwcname.deploypages.siteApuntar tráfico a la plataforma
TXT_deploypages-challengedeploypages-verify=...Verificar propiedad del dominio

Elegir el valor de host

  • Usa www cuando conectes www.example.com.
  • Usa @ cuando conectes el dominio raíz example.com.
  • Usa una etiqueta de subdominio, como blog, cuando conectes blog.example.com.

Actualizar un sitio

Mismo proceso, nueva versión

Actualizar un proyecto sigue la misma lógica que la primera publicación: construye la salida nueva, súbela y deja que la plataforma reemplace la versión activa.
  • 1
    Edita los archivos fuente

    Cambia texto, estilos, medios o recursos localmente.

  • 2
    Reconstruye si hace falta

    Si el proyecto usa framework, genera primero una carpeta de build actualizada.

  • 3
    Abre el proyecto en el panel

    Regresa a la página del proyecto dentro de DeployPages.

  • 4
    Sube la nueva versión

    Reemplaza el build anterior por la carpeta más reciente. El historial mantiene la nueva publicación trazable.

Cuando termina la carga, la nueva versión queda en línea y las versiones anteriores permanecen disponibles para restauración.

Preguntas frecuentes

¿Puede usar DeployPages alguien que no programa?
Sí. Si el sitio ya está exportado como archivos estáticos, subir la carpeta desde el navegador es suficiente.
¿Por qué veo un 404 después de publicar?
La causa más común es que falta index.html o está dentro de una subcarpeta. Asegúrate de que el archivo de entrada esté en la raíz de la carpeta subida.
¿Qué pasa si las rutas de React o Vue fallan al refrescar?
DeployPages soporta comportamiento de fallback para setups front-end estáticos comunes, pero el build debe estar exportado correctamente.
¿Puedo subir videos o archivos grandes?
Sí, pero el rendimiento mejora cuando los medios muy pesados se optimizan o se entregan desde un canal especializado.
¿Puedo proteger un sitio con contraseña?
Sí, en planes que incluyen protección con contraseña. Úsala para vistas previas, docs internas o lanzamientos en preparación.