Deploy de un sitio estático (HTML, React, Vite)

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, Discord, GitHub o Google).
• 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. Para React/Vite, ejecuta npm run build y sube el contenido de dist/ (o build/). Si la app usa enrutamiento en el cliente (React Router, Vue Router etc.), renombra el index.html del build a vite.html para que las rutas desconocidas sirvan la app. Un sitio con un HTML por página mantiene el index.html y usa el 404.html.
• 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

2. Autentícate en la CLI: ejecuta el comando a continuación; la CLI muestra un código y abre la página de autorización en el navegador. Para usar una clave creada en Mi cuenta > Seguridad, ejecuta squarecloud auth login --token <clave>.

squarecloud auth login

3. Crea tu archivo de configuración: el archivo de configuración, squarecloud.config o squarecloud⁠.app, debe estar presente en tu proyecto.
4. Haz el upload:

squarecloud upload

• O si creaste el zip:

squarecloud upload --file <ruta/al/zip>

Actualizado el: 04/10/2026