Tu primer sitio

Este tutorial va más allá de Quickstart. Conectamos un repositorio, miramos el manifiesto del sitio que produce Showly, hacemos un cambio directamente en el editor y lo enviamos.

Conectar el repositorio

Desde la página de inicio del espacio de trabajo, haga clic en Conectar un sitio. Se abre el cuadro de diálogo de la aplicación GitHub. Elegir:

• la organización o cuenta personal propietaria del repositorio
• el repositorio que deseas conectar

La aplicación GitHub solicita Contenido: lectura y escritura en los repositorios que seleccione; GitHub lo otorga a nivel de repositorio, no por sucursal. Como política de producto, Showly solo se compromete con ramas bajo el prefijo showly/*; no envía a su rama predeterminada.

Después de autorizar, el repositorio aparece en su espacio de trabajo con el estado Importando.

Revisar el manifiesto del sitio

El paso de importación escribe un manifiesto showly.json en el espacio de trabajo importado. Este es un punto de partida detectado automáticamente: Showly inspecciona el repositorio y propone valores; puede revisar y anular cualquier campo posteriormente. Se parece a esto:

{
  "rootDirectory": ".",
  "runtime": "node",
  "runtimeVersion": "22",
  "packageManager": "pnpm",
  "installCommand": "pnpm install",
  "buildCommand": "pnpm build",
  "output": {
    "directory": ".next"
  }
}

El marco se detecta automáticamente (Showly reconoce Astro, Vite, exportación Next.js y HTML estático simple), por lo que no es un campo que usted establezca en el manifiesto.

El manifiesto es la fuente de verdad que Showly utiliza para cada compilación y cada consulta de contexto de agente. Si el proceso de compilación de su repositorio cambia, edite el manifiesto; no luche contra la detección automática de Showly. Consulte Manifiesto del sitio para obtener el esquema completo y la referencia de campo.

Establecer variables de entorno

Abra el panel Entorno del sitio y configure las variables que su compilación y tiempo de ejecución necesitan. Showly nunca lee secretos de tu repositorio; los configura por entorno (preview, production), por lo que una compilación de vista previa puede usar valores diferentes a los de producción.

Realizar un cambio en el editor

El editor Showly abre un panel de chat junto a un árbol de archivos. Intentar:

Agrega una nueva ruta /about con una breve biografía.

El agente responderá con un plan de cambios que enumera los archivos que creará. Haga clic en Aplicar plan para materializar el parche en un espacio de trabajo aislado, crear y producir una vista previa.

La compilación pasa por queued → building y aterriza en ready (un pequeño cambio típico tarda menos de un minuto). Cuando llega a ready, la URL de vista previa aparece en el panel Vista previa; ábrelo para ver el cambio en vivo en una implementación de vista previa aislada. Si, en cambio, la compilación termina en failed, expanda la implementación para leer los registros de compilación, solucione el problema (a menudo un comando de compilación o una configuración de tiempo de ejecución en el manifiesto) y aplique nuevamente.

Publicar

En el panel Lanzamientos, elige la ready Vista previa que deseas enviar. La publicación nunca requiere inscripción OTP/MFA.

Quién puede aprobar depende de su plan. En los planes con flujos de trabajo de aprobación habilitados, una solicitud de publicación necesita una aprobación de owner o admin, y el solicitante no puede autoaprobarse. En Free y Pro no hay un segundo revisor: haga clic en Publicar o utilice la confirmación de dos pasos publish_site del agente.

Lo que acabas de ejercitar

• GitHub importar → manifiesto del sitio
• Variaciones ambientales por entorno
• Chat → cambiar plan → parche → vista previa
• Aprobación → publicación de producción.

Ese es todo el ciclo de publicación. Cada flujo de trabajo posterior en Showly es una variación de esta misma ruta.