> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://squarecloud.app/pt-br/signup) (correo o GitHub).
* **Plan Activo:** Es necesario un plan de pago para alojar. Consulta los [precios aquí](https://squarecloud.app/pt-br/pricing).

---

> **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
```
2. 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**](https://squarecloud.app/pt-br/account/security) y solicitando la clave API; luego, autentícate en la CLI con el siguiente comando.
```
squarecloud auth login
```
3. Crea tu archivo de configuración: el [archivo de configuración](https://docs.squarecloud.app/pt-br/getting-started/config-file), `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 <caminho/para/zip>
```