Saltar al contenido principal
El runtime estático sirve HTML, CSS, JavaScript, imágenes y otros archivos directamente desde tu ZIP, con un servidor web gestionado por Square Cloud. No hay ningún proceso tuyo que mantener en ejecución, así que es la forma más ligera de publicar un sitio web.

​
Antes de empezar

  • Un editor de texto para tus archivos HTML y CSS, como Visual Studio Code.
  • Una cuenta de Square Cloud: regístrate con tu email o GitHub.
  • Un plan activo. Consulta los planes y elige el que se ajuste a tu proyecto.

​
Sitios estáticos y apps renderizadas en el servidor

Un sitio estático es un conjunto de archivos que es igual para todos los visitantes: páginas HTML simples o la salida del build de un framework como Vite, React, Vue, Angular, Astro o Gatsby. El runtime estático sirve esos archivos tal como están. Una app renderizada en el servidor genera las páginas en cada solicitud, con código de servidor como Next.js, Nuxt, React Router o una API. Necesita un proceso que siga en ejecución, así que corre en un runtime de lenguaje, como el runtime de Node.js, con un archivo MAIN o un comando START. Si tu framework permite las dos cosas, un build estático es la opción más ligera. Cada guía de framework indica qué opciones admite.

​
Configurar Square Cloud

Si subes tu aplicación a través del dashboard, puedes omitir esta sección: el dashboard crea el archivo de configuración squarecloud.app por ti.

Referencia del archivo de configuración

El archivo squarecloud.app le indica a Square Cloud cómo ejecutar tu aplicación: su archivo principal, la memoria, la versión del runtime, el nombre y, para un sitio web, su subdominio.
Un MAIN que apunta a un archivo HTML selecciona el runtime estático:
squarecloud.app
512 MB es la memoria mínima para un sitio web, y es de sobra para archivos estáticos.

​
Cómo sirve los archivos el runtime estático

  • La raíz del ZIP es la raíz de tu sitio: about.html se sirve en /about.html, y blog/index.html en /blog/.
  • / sirve vite.html si existe; si no, index.html.
  • Cuando una ruta no coincide con ningún archivo, el runtime sirve vite.html si existe. Así las rutas del lado del cliente de las aplicaciones de página única siguen funcionando al recargar, sea cual sea el framework: renombra el index.html del build a vite.html.
  • Sin vite.html, las rutas desconocidas devuelven tu 404.html, o una página 404 predeterminada si no tienes una.
  • Los archivos se comprimen al vuelo, y tu archivo squarecloud.app nunca se sirve.
Todos los archivos del ZIP son públicos. No subas código fuente, archivos .env ni nada que no quieras que los visitantes descarguen.

​
Preparar el proyecto

Pon tus archivos en la raíz del ZIP, junto a squarecloud.app:
  • index.html, o vite.html para una aplicación de página única.
  • Tus archivos CSS, JavaScript, imágenes y fuentes, con cualquier estructura de carpetas.
  • 404.html, opcional: la página para rutas que no existen.
Para el build de un framework, comprime el contenido de la carpeta de salida del build, no la carpeta en sí.

​
Guías de frameworks

Cada guía muestra el comando de build, la carpeta de salida y cómo publicarla en el runtime estático.

Vite

React

Vue

Angular

Astro

Gatsby

Preact

Qwik

SolidJS

Nuxt

​
Solución de problemas

La página dice “Hi, I’m Square Shield”: el runtime no encontró index.html ni vite.html en la raíz del ZIP. Probablemente comprimiste la carpeta del build en lugar de su contenido: comprime los archivos que hay dentro.
Tu aplicación de página única gestiona las rutas en el navegador. Renombra su index.html a vite.html para que las rutas desconocidas carguen la app, y actualiza MAIN.
Para otros problemas, consulta Solución de problemas.

​
Hacer deploy

​
A través del panel

1

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.
2

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
3

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.
Subiendo aplicación a Square Cloud
4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​
A través de la CLI

Para usar este método, tu proyecto necesita un archivo de configuración llamado squarecloud.app en su raíz. Le indica a Square Cloud cómo ejecutar tu aplicación.

Guía del archivo de configuración

Aprende a crear el archivo de configuración squarecloud.app que define el entorno de tu aplicación.
1

Instala la CLI

Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:
2

Inicia sesión

Ejecuta el comando de abajo. Abre tu navegador: aprueba el inicio de sesión allí y la CLI queda lista. No hay ninguna clave de API que copiar. Para scripts y CI, consulta autenticación de la CLI.
3

Sube tu proyecto

Desde la carpeta de tu proyecto, ejecuta el comando de abajo. La CLI comprime la carpeta actual en un zip, dejando fuera lo que lista squarecloud.ignore, y lo sube:
Para subir un zip que creaste tú mismo, pásalo con --file:
4

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal:
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​
Próximos pasos

Variables de entorno

Mantén secretos y ajustes fuera de tu código y léelos en tiempo de ejecución.

Dominio personalizado

Sirve tu app en tu propio dominio, desde el plan Standard.

Solución de problemas

Arregla una app que no inicia o un sitio que no responde.

​
Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema: la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.