> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Implementaciones de aplicaciones

> Despliega aplicaciones web directamente desde Windsurf en Netlify, con URL públicas, compilaciones automáticas y la posibilidad de reclamar proyectos de Next.js, React, Vue y Svelte.

Implementaciones de aplicaciones te permite desplegar aplicaciones web y sitios directamente en Windsurf mediante llamadas a herramientas de Cascade. Esta función te ayuda a compartir tu trabajo a través de URL públicas, actualizar tus despliegues y reclamar proyectos para personalizarlos más. Esta función está en beta y pronto incorporará compatibilidad con más frameworks, compilaciones más robustas, etc.

<Frame>
  <img src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/app-deploys-ui.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=af9bd2cc96a163d94b37138e4b07175b" width="2072" height="576" data-path="assets/windsurf/cascade/app-deploys-ui.png" />
</Frame>

<div id="overview">
  ## Descripción general
</div>

Con Implementaciones de aplicaciones, puedes:

* Implementar un sitio web o una aplicación web en JavaScript en un dominio público
* Volver a implementar en la misma URL después de realizar cambios
* Reclamar el proyecto en tu cuenta personal

<Warning>
  Implementaciones de aplicaciones está pensado principalmente para vistas previas. Para aplicaciones de producción con datos sensibles, recomendamos reclamar tu implementación y seguir las prácticas recomendadas de seguridad.
</Warning>

<div id="supported-providers">
  ## Proveedores compatibles
</div>

Actualmente admitimos el siguiente proveedor de implementación:

* **Netlify** - Para sitios web estáticos y aplicaciones web

<Note>Está previsto añadir compatibilidad con proveedores adicionales en versiones futuras.</Note>

<div id="how-it-works">
  ## Cómo funciona
</div>

Cuando usas Implementaciones de aplicaciones, tu código se sube a nuestro servidor y se despliega en el proveedor bajo nuestra cuenta general. El sitio desplegado estará disponible en una URL pública con el siguiente formato:

```
<SUBDOMAIN_NAME>.windsurf.build
```

<video autoPlay muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/app-deploys-demo1.mp4?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=844977e5cf94c8393e2418bdaec2e921" data-path="assets/windsurf/cascade/app-deploys-demo1.mp4" />

<div id="deployment-process">
  ### Proceso de despliegue
</div>

1. Cascade analiza tu proyecto para determinar el framework adecuado
2. Los archivos de tu proyecto se cargan de forma segura en nuestro servidor
3. El despliegue se crea en la plataforma del proveedor
4. Recibes una URL pública y un enlace para reclamarlo

<div id="project-configuration">
  ### Configuración del proyecto
</div>

Para facilitar los redepliegues, creamos un archivo `windsurf_deployment.yaml` en la raíz de tu proyecto. Este archivo contiene información para despliegues futuros, como el ID del proyecto y el framework.

<div id="using-app-deploys">
  ## Uso de Implementaciones de aplicaciones
</div>

Para implementar tu aplicación, simplemente pídele a Cascade algo como:

```
"Despliega este proyecto en Netlify"
"Actualiza mi despliegue"
```

Cascade te guiará durante el proceso y te ayudará a resolver problemas comunes.

<div id="team-deploys">
  ## Despliegues del equipo
</div>

<Note>Necesitarás permisos de administrador del equipo para activar o desactivar esta función.</Note>

Los usuarios con planes Teams y Enterprise pueden conectar sus cuentas de Netlify con sus cuentas de Windsurf y desplegar en su equipo de Netlify.

Esta opción se puede activar o desactivar en la configuración del equipo, a la cual puedes acceder desde la página de Perfil o haciendo clic [aquí](https://windsurf.com/team/settings).

<div id="security-considerations">
  ## Consideraciones de seguridad
</div>

<Warning>
  Tu código se subirá a nuestros servidores para su despliegue. Solo despliega código
  que te sientas cómodo compartiendo públicamente.
</Warning>

Tomamos varias precauciones para garantizar la seguridad:

* Límites de tamaño de archivo y validación
* Limitación de solicitudes según tu plan de cuenta
* Manejo seguro de archivos del proyecto

Para mayor privacidad, visita [clear-cookies.windsurf.build](https://clear-cookies.windsurf.build) para comprobar y borrar cualquier cookie establecida por sitios bajo `windsurf.build`. Si aparece alguna cookie, no debería estar allí; al borrarla, ayudas a prevenir problemas de cookies entre sitios y mantienes tu experiencia limpia.

Los sitios de Windsurf son creados por personas y por IA; aunque incentivamos que la IA tome decisiones basadas en buenas prácticas, es sensato mantener la cautela. Windsurf no se hace responsable de los problemas causados por sitios desplegados por nuestros usuarios.

<div id="claiming-your-deployment">
  ## Reclamación de tu despliegue
</div>

Después de desplegar, recibirás una URL de reclamación. Al seguir este enlace, podrás reclamar el proyecto en tu cuenta personal del proveedor, lo que te brindará:

* Control total sobre el despliegue
* Acceso a funciones específicas del proveedor
* Posibilidad de modificar el nombre de dominio
* Acceso directo a logs e información de compilación

<Note>
  Los despliegues no reclamados pueden eliminarse después de cierto tiempo. Recomendamos
  reclamar los proyectos importantes sin demora.
</Note>

<div id="rate-limits">
  ## Límites de uso
</div>

Para prevenir abusos, aplicamos estos límites por nivel:

| Plan | Despliegues por día | Máx. de sitios sin reclamar |
| ---- | ------------------- | --------------------------- |
| Free | 1                   | 1                           |
| Pro  | 10                  | 5                           |

<div id="supported-frameworks">
  ## Frameworks compatibles
</div>

Implementaciones de aplicaciones funciona con los frameworks de JavaScript más populares, entre ellos:

* Next.js
* React
* Vue
* Svelte
* Sitios estáticos HTML/CSS/JS

<div id="troubleshooting">
  ## Resolución de problemas
</div>

<div id="failed-deployment-build">
  ### Error en la compilación del despliegue
</div>

Si tu despliegue falla:

1. Revisa los logs de compilación proporcionados por Cascade
2. Asegúrate de que tu proyecto pueda compilarse localmente (ejecuta `npm run build` para probar)
3. Verifica que tu proyecto siga la estructura recomendada del framework
4. Consulta la documentación sobre cómo desplegar [tu framework en Netlify mediante `netlify.toml`](https://docs.netlify.com/configure-builds/file-based-configuration/)
5. Considera reclamar el proyecto para acceder a logs detallados en el panel del proveedor

<Warning>
  No podemos brindar soporte directo para errores de compilación específicos del framework. Si tu
  despliegue falla debido a problemas de código, depura localmente o reclama el proyecto para
  trabajar con el equipo de soporte del proveedor.
</Warning>

<div id="netlify-site-not-found">
  ### Sitio de Netlify no encontrado
</div>

<Frame>
  <img src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/netlify-site-not-found.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=80793d24da70db2cfd1021616c6db559" width="2430" height="1618" data-path="assets/windsurf/cascade/netlify-site-not-found.png" />
</Frame>

Es probable que la compilación haya fallado. Reclama tu sitio (puedes encontrarlo en tu [historial de despliegues](https://windsurf.com/deploy)) y revisa los logs de compilación para más detalles. A menudo puedes pegar tus logs de compilación en Cascade y pedir ayuda.

<div id="changing-your-subdomain-url">
  ### Cambiar tu subdominio o URL
</div>

<div id="updating-netlifyapp-domain">
  #### Actualización del dominio `netlify.app`
</div>

Puedes cambiar tu subdominio al reclamar tu despliegue y actualizar la configuración del sitio en Netlify. Esto actualizará tu dominio `.netlify.app`.

<div id="updating-custom-windsurfbuild-subdomain">
  #### Actualización del subdominio personalizado `.windsurf.build`
</div>

<Warning>
  No puedes cambiar tu subdominio personalizado `.windsurf.build` después de
  haber hecho el despliegue. En su lugar, tendrás que desplegar un sitio nuevo con un subdominio nuevo.
</Warning>

Para actualizar tu subdominio personalizado `.windsurf.build`, tendrás que desplegar un sitio nuevo con un subdominio nuevo:

1. Elimina el archivo `windsurf_config.yaml` de tu proyecto
2. Pídele a Cascade que despliegue un sitio nuevo con un subdominio nuevo y especifica cuál quieres
3. Puede ayudar iniciar una conversación nueva o borrar tus memorias autogeneradas para que Cascade no intente volver a desplegar en el subdominio anterior
4. Cuando crees un nuevo despliegue, podrás hacer clic en el botón "Edit" en la interfaz del subdominio para actualizarlo antes de hacer clic en "Deploy"

<div id="error-unable-to-get-project-name-for-project-id">
  ### Error: `Unable to get project name for project ID`
</div>

Este error ocurre cuando tu ID de proyecto no se encuentra en nuestro sistema de registros o si Cascade está usando incorrectamente el subdominio como ID de proyecto. Para solucionarlo:

1. Comprueba que el proyecto aún exista en tu cuenta de Netlify (suponiendo que esté reclamado).
2. Comprueba que el ID de proyecto esté en el archivo `windsurf_deployment.yaml`. Si no está en el archivo, puedes descargar el archivo de configuración desde el menú desplegable de tu [historial de implementaciones](https://windsurf.com/deploy).
3. Intenta volver a implementar e indicarle a Cascade que use el `project_id` del archivo `windsurf_deployment.yaml` de forma explícita.

<Frame>
  <img src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/app-deploys-download-config-file.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=8e8633a61f54753db07de541413ace9c" width="1966" height="1408" data-path="assets/windsurf/cascade/app-deploys-download-config-file.png" />
</Frame>