Artículos sobre: Websites & APIs

Cómo desplegar un sitio estático (HTML, React, Vite) en Square Cloud

1. Requisitos previos

Antes de subir tu sitio, verifica que tengas:

  • Cuenta en Square Cloud: Crea tu cuenta vía Página de Registro (correo o GitHub).
  • Plan Activo: Es necesario un plan de pago para alojar. Consulta los precios aquí.



Nota: Square Cloud tiene soporte nativo para sitios estáticos con CDN premium incluida, garantizando que tu sitio cargue rápido en cualquier lugar del mundo.


2. Estructura de archivos obligatorios

Asegúrate de que tu proyecto tenga al menos el archivo principal en la raíz:


  • index.html: El archivo principal de tu sitio. O vite.html, si utilizas el framework Vite.
  • 404.html: (Opcional) Página personalizada para errores de "Not Found".



3. Preparando el proyecto

Antes de enviar, verifica que todos los enlaces a archivos CSS e imágenes funcionen localmente.


Aviso importante: No necesitas crear archivos de configuración ahora, pues el sistema creará el archivo squarecloud.app automáticamente para ti si envías vía dashboard.



4. Cómo alojar (Upload)

Con los archivos listos, tienes dos caminos principales para poner el sitio en línea:


Opción A: Vía dashboard (más fácil)

  1. Accede al panel de Square Cloud.
  2. Haz clic en Enviar Aplicación.
  3. Selecciona la carpeta de tu proyecto o arrastra el archivo .zip.
  4. Indica el nombre de la aplicación, apunta tu archivo principal y marca publicación en la web para definir tu subdominio squareweb.app.


Consejo: Los proyectos estáticos no necesitan un "servidor" en ejecución (como Node.js o Python); la propia Square Cloud ya configura un servidor nginx para ti.


Opción B: Vía CLI


  1. Instala la CLI:
npm i -g @squarecloud/cli
  1. Autentícate en la CLI: Obtén tu token de API en la página de Mi Cuenta, yendo a la sección Autenticación y solicitando la clave API; luego, autentícate en la CLI con el siguiente comando.
squarecloud auth login
  1. Crea tu archivo de configuración: el archivo de configuración, squarecloud.config o squarecloud.app, debe estar presente en tu proyecto.
  2. Haz el upload:
squarecloud upload
  • O si creaste el zip:
squarecloud upload --file <caminho/para/zip>

Actualizado el: 13/06/2026

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!