Communitygithub.com

Landing Launch — hosting Cloudflare, conversión y formulario

Prepara una landing ya construida para lanzarla: hosting estático en Workers, Web Analytics sin cookies, un evento de conversión para el único CTA, un Worker de formulario de leads funcional, test A/B opcional y checklist en landing/launch.md. Todo se prueba en local y nunca despliega ni toca el DNS sin el visto bueno del usuario.

¿Qué es Landing Launch — hosting Cloudflare, conversión y formulario?

Receta Landing Pages, paso 3 (lanzar): landing-launch de Im-Fran/landing-skills. Lee el build y landing/brief.md, identifica el stack (HTML plano, Astro, Vite/React, Next.js) y escribe la config de hosting, el Worker del formulario, el snippet de analítica y un contador de conversiones en Workers Analytics Engine. Los comandos de Cloudflare se verificaron con la documentación el 2026-10-04 y se ejecutaron con Wrangler 4.147.0; el skill pide reverificar, incluye una ruta sin Cloudflare y deja aviso de privacidad y contactos como placeholders visibles hasta que los aportes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-launch

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Lanzamiento de la página de aterrizaje

Prepara una página de aterrizaje construida para su lanzamiento: alojamiento, análisis de página, un evento de conversión para su única llamada a la acción, un formulario de leads funcional, una prueba A/B opcional y una lista de verificación de lanzamiento. La habilidad prepara y prueba todo localmente. Nunca despliega ni cambia DNS sin la aprobación del usuario.

Los comandos, claves de configuración y límites de Cloudflare cambian. Los aquí incluidos se verificaron con la documentación de Cloudflare el 2026-10-04 y el código del Worker se ejecutó con Wrangler 4.147.0. Antes de confiar en un comando o límite, confírmalo en la documentación actual de Cloudflare y confía en la documentación donde difiera de esta habilidad.

Entradas

Lee primero los archivos y pregunta al usuario solo por lo que deje abierto, en un solo mensaje.

EntradaDóndeSi falta
La página construida, y /thanks/ y /form-error/ cuando el formulario se envía al Worker de esta habilidadLa salida de la construcción (dist/, public/, una carpeta de exportación), escrita por landing-skills:landing-buildEjecuta la construcción. Si aún no hay página, detente y di que la página viene primero (landing-skills:landing-build).
La acción de conversión: formulario o página externa, los campos del formulario, el estado del endpoint (ninguno aún o una URL), o la URL externaConversion action en landing/brief.mdLéela de la página: la action del formulario y el name de cada campo, o el enlace principal. Confirma con el usuario en una pregunta.
Cada name de campo que envía el formulario y el estado del endpointLa transferencia de la construcción; de lo contrario, los atributos name del formulario construidoLéelos del formulario construido.
DominioDomain en landing/brief.mdPregunta. Si permanece desconocido, usa la dirección workers.dev y marca los elementos del dominio como pendientes.
Rutas de contacto, para /form-error/ y el pie de páginaContact routes en landing/brief.mdPregunta. Hasta que se responda, un [PLACEHOLDER: ...] visible, elemento pendiente.
Mensajes del formulario, de agradecimiento y de errorlanding/copy.mdEscribe mensajes cortos y simples en el idioma de la página y enuméralos para que el usuario los apruebe.
Elección de alojamientoel usuarioRecomienda Cloudflare (abajo). Si se niega, ve a No usar Cloudflare.
Aviso de privacidadel pie de página de la página y el formularioPregunta al usuario por él; hasta entonces un [PLACEHOLDER: ...] visible, elemento pendiente. Nunca inventes uno.

Lo que escribe esta habilidad: configuración de alojamiento, el Worker del formulario cuando sea necesario, el fragmento de análisis y el evento de conversión, y landing/launch.md con la lista de verificación. No escribe copia ni reescribe las páginas de la construcción.

Identifica el stack (HTML plano, Astro, Vite con React, Next.js) y su carpeta de salida antes de escribir cualquier configuración.

Recomendación

Sugiere Cloudflare para los tres trabajos y explica por qué en estos términos:

  • Alojamiento: Los activos estáticos de Workers sirven la página; las solicitudes estáticas son gratuitas e ilimitadas en el plan Free, y Cloudflare recomienda Workers sobre Pages para nuevos proyectos. El mismo proyecto puede ejecutar un Worker pequeño para el formulario, por lo que la página no necesita otro backend.
  • Análisis: Cloudflare Web Analytics cuenta el tráfico y las Core Web Vitals sin cookies ni fingerprinting. No tiene eventos personalizados, por lo que la conversión se cuenta mediante el Worker en Workers Analytics Engine, en la misma cuenta, gratis en el plan Free.
  • Pruebas A/B: el mismo Worker puede asignar variantes en el borde antes de que se sirva la página. Sin script de prueba del lado del cliente, sin parpadeo, y funciona con JavaScript desactivado.

Indica también los costos: un dominio personalizado necesita el DNS del dominio en Cloudflare, y cada solicitud que ejecuta el Worker cuenta contra 100,000 por día en el plan Free.

Proceso

  1. Lee las entradas. De landing/brief.md, toma la acción de conversión (formulario o página externa, sus campos, el estado del endpoint), el dominio y las rutas de contacto. De la página construida, observa cada formulario con su action y nombres de campo, y cada enlace de llamada a la acción. Pregunta solo lo que aún falta.

    Luego elige el caso, que decide qué agregas:

    • Formulario, endpoint ninguno aún (envía a /api/lead, que nada sirve aún): el Worker del formulario, pasos 4 y 5.
    • Formulario, endpoint existe: sin Worker de formulario ni Turnstile. Verifica que el formulario envíe a ese endpoint y que las páginas de resultado coincidan con lo que devuelve, y registra que la validación y la protección contra spam son trabajo de ese endpoint.
    • Página externa (checkout, reserva, tienda de aplicaciones): sin formulario que manejar. El enlace va a la URL real y el clic se cuenta con la baliza en el paso 5; los elementos del formulario en la lista de verificación son n/a.
  2. Arregla primero los callejones sin salida. Busca en la construcción un formulario cuya acción no lleve a ninguna parte o cuyo envío se cancele, un controlador de envío que solo muestre un mensaje de agradecimiento, enlaces a un # vacío, y botones que enlacen a la sección en la que están. Cada uno de estos significa que la conversión no existe. Un formulario obtiene el endpoint del Worker en el paso 4; un enlace obtiene la URL real del usuario, o un [PLACEHOLDER: ...] visible y un elemento pendiente en la lista de verificación.

  3. Configuración de alojamiento. Escribe wrangler.jsonc para el stack, instala Wrangler en el proyecto, agrega 404.html si falta, y agrega _headers o _redirects solo cuando haya algo que poner en ellos. Lee references/hosting.md.

  4. Endpoint del formulario (formulario, endpoint ninguno aún). Agrega el Worker del formulario: validación del servidor, verificación de Turnstile con Siteverify, almacenamiento D1, y las rutas de respuesta con JavaScript y sin JavaScript. Agrega el widget de Turnstile al formulario de la construcción; mantén el marcado y el script de mejora de la construcción. Verifica que /thanks/ y /form-error/ existan y que /form-error/ ofrezca una ruta de contacto del brief. Crea una página de resultado solo si falta, y nunca sobrescribas una: landing-skills:landing-build las posee. Lee references/forms.md.

    Cada campo se maneja. Enumera cada name de campo que el formulario envía y asigna a cada uno una entrada en la tabla FIELDS del Worker (obligatorio o no, un límite de longitud, una verificación de formato cuando sea significativa, de lo contrario texto con un límite), una columna en la tabla leads, y un MAX_BYTES que los contenga a todos. Nada se almacena sin validar. Un campo enviado que el Worker no maneje falla la lista de verificación; el Worker rechaza tal envío con unknown_field, lo que hace visible la brecha en las pruebas, pero el envío del visitante se pierde hasta que se agregue el campo.

  5. Análisis y evento de conversión. Agrega el fragmento de Web Analytics a cada página y registra la conversión en Analytics Engine: en el Worker del formulario cuando lo agregaste, mediante baliza para un enlace. Con un endpoint existente, la conversión se cuenta a partir de los registros de ese endpoint, y la baliza es una opción. Lee references/analytics.md.

  6. Prueba A/B, solo si se solicita. Acuerda el único cambio, la línea base, la diferencia más pequeña que valga la pena actuar y el tamaño de la muestra antes de escribir cualquier código. Luego agrega el archivo de variante y el Worker A/B. Lee references/ab-testing.md.

  7. Prueba localmente. Ejecuta npx wrangler dev con claves de prueba de Turnstile en .dev.vars y ejercita cada ruta con curl y un navegador: envío válido con todos los campos, correo electrónico no válido, cada campo por encima de su límite, Turnstile fallido, JavaScript desactivado, y para una prueba: asignación, la cookie persistente en una segunda solicitud, el endpoint de conversión. Luego ejecuta npx wrangler deploy --dry-run y verifica el recuento y tamaño de los activos. Las ejecuciones locales no necesitan cuenta. Arregla todo lo que falle antes de continuar.

  8. Detente para la aprobación. Desplegar, crear una vista previa, agregar un dominio personalizado o ruta, crear una base de datos D1, ejecutar d1 execute --remote, establecer un secreto, crear el widget de Turnstile y agregar el sitio a Web Analytics cambian todos la cuenta de Cloudflare del usuario, y un despliegue o cambio de DNS es visible para el público de inmediato. El usuario puede estar en medio de una revisión, el dominio puede aún servir un sitio antiguo, y un cambio incorrecto de DNS puede dejar un sitio en vivo caído. Por lo tanto, enumera cada paso hacia el exterior con su comando exacto y lo que cambiará, y ejecuta cada uno solo cuando el usuario diga que sí en ese momento. Un sí a un paso no es un sí al siguiente. Si el usuario prefiere ejecutarlos, entrega los comandos en orden.

  9. Después del despliegue (con el usuario). Envía el formulario en vivo una vez, confirma la fila en D1 y la conversión en Analytics Engine, confirma que Web Analytics muestra la visita, y verifica los elementos de la lista de verificación que solo se pueden verificar en vivo.

  10. Escribe landing/launch.md. Registra la configuración de alojamiento, la acción de conversión y cómo se cuenta, el plan A/B si lo hay, los comandos para los pasos hacia el exterior, y la lista de verificación de lanzamiento con cada elemento marcado done, pending, fail o n/a y la razón para cada uno que no sea done. Muestra la lista de verificación al usuario.

Lista de verificación de lanzamiento

Copia esto en landing/launch.md y marca cada línea done, pending (reason), fail (reason) o n/a (reason). Un elemento que no pudiste verificar está pendiente, nunca hecho. Los elementos del formulario son n/a cuando la llamada a la acción es una página externa.

Conversión

  • La llamada a la acción lleva a una acción funcional: el formulario envía a /api/lead (o al endpoint existente del usuario), o el enlace va a la URL real del usuario. Sin href="#", sin auto-ancla, sin éxito falso.
  • Cada name de campo que el formulario envía tiene una entrada FIELDS con un límite de longitud y una columna leads. Cualquier campo no manejado es un fallo, nunca un pase.
  • Con un endpoint existente: responde JSON con ok para Accept: application/json y redirige a /thanks/ o /form-error/ de lo contrario, o las páginas de resultado coinciden con lo que devuelve; la validación y la protección contra spam se registran como su trabajo.
  • Cuando el formulario envía al Worker de esta habilidad: /thanks/ y /form-error/ existen (las páginas propias de la construcción, no sobrescritas), y /form-error/ ofrece una ruta de contacto del brief. Con un endpoint existente, las páginas coinciden con lo que devuelve; con un enlace externo, n/a.
  • Formulario probado localmente: envío válido, correo electrónico no válido, Turnstile fallido, JavaScript desactivado (aterriza en /form-error/).
  • El botón se deshabilita mientras envía; el éxito y el error se anuncian en un elemento role="status".
  • El honeypot está oculto a la vista y a la tecnología de asistencia.
  • Formulario en vivo probado una vez después del despliegue; la fila está en D1.
  • Sin promesa de un correo de confirmación a menos que el usuario tenga una forma de enviarlo.

Medición

  • Fragmento de Web Analytics en vivo con el token real en cada página (pendiente: el fragmento está en un comentario HTML hasta que exista el token), incluyendo /thanks/, /form-error/ y 404.html.
  • La conversión se escribe en Analytics Engine, y una conversión de prueba en vivo aparece en la consulta SQL.
  • Web Analytics muestra la visita en vivo.
  • Durante una prueba A/B: los recuentos de visitantes y conversiones por variante aparecen, y el tamaño de la muestra y la regla de finalización se escriben en landing/launch.md.

Alojamiento

  • npx wrangler deploy --dry-run pasa; archivos de activos bajo 20,000, ninguno sobre 25 MiB.
  • El dominio personalizado sirve la página sobre HTTPS; workers_dev configurado como el usuario desea.
  • Redirecciones en _redirects probadas en vivo.
  • Las rutas desconocidas devuelven el 404.html personalizado con estado 404.

Página

  • Etiquetas de título, meta descripción, URL canónica y Open Graph y tarjeta social presentes; la imagen de la tarjeta se carga desde la URL en vivo y la vista previa se ve correcta cuando el enlace se pega en un depurador de compartir o una aplicación de chat.
  • robots.txt y un sitemap que enumera la URL en vivo; las páginas de resultado y vistas previas son noindex.
  • Favicon presente.
  • Aviso de privacidad enlazado junto al formulario y en el pie de página, nombrando Turnstile (un script de Cloudflare) y cada campo que almacena el formulario, por nombre; detalles de contacto (correo electrónico, teléfono o el canal de mensajería que la audiencia realmente usa) y quién dirige el sitio.
  • Cualquier declaración de "sin cookies" sigue siendo cierta (no lo es mientras una prueba A/B establece su cookie).
  • Cada [PLACEHOLDER: ...] resuelto: fotos y capturas de pantalla reales en su lugar, precios y fechas confirmados.

Cuentas y secretos

  • Widget de Turnstile creado para el nombre de host de producción; la sitekey real está en el HTML.
  • TURNSTILE_SECRET configurado con wrangler secret put (nunca comprometido); .dev.vars* y .wrangler/ en .gitignore.
  • Cada paso hacia el exterior fue confirmado por el usuario antes de ejecutarse.

No usar Cloudflare

La construcción es salida estática simple: HTML, CSS, JavaScript y activos en una carpeta. Cualquier host estático o el propio servidor del usuario puede servirla tal cual.

Si el usuario no quiere Cloudflare, no agregues archivos de Cloudflare: sin wrangler.jsonc, sin Worker, sin Turnstile, sin fragmento de Web Analytics, sin .dev.vars. Elimina cualquier que hayas agregado antes en la sesión. Luego ve directamente a la lista de verificación de lanzamiento y trabaja a través de los elementos que no nombren un producto de Cloudflare. Para el formulario y la conversión, los elementos de la lista de verificación aún aplican: el formulario necesita un endpoint real en el servidor o servicio del usuario, validado en el servidor, y la conversión necesita una forma de ser contada. Nombra lo que falta, márcalo como pendiente y deja la elección de la herramienta al usuario. Esta habilidad no da recetas para otros hosts.

Autoverificación

Antes de informar:

  • Nada se desplegó, previsualizó, enrutó o creó en la cuenta del usuario sin un sí para ese paso.
  • Cada cambio de configuración pasó npx wrangler deploy --dry-run, y las verificaciones locales con curl dieron los códigos de estado esperados.
  • Ningún archivo afirma que Web Analytics cuenta clics o conversiones.
  • Ningún secreto, token o id de cuenta se escribe en un archivo comprometido.
  • landing/launch.md existe, y cada línea de la lista de verificación está marcada, con una razón para cada una que no sea done, y ningún campo de formulario enviado queda sin manejar.

Referencias

  • references/hosting.md: configuración por stack, comandos, la ejecución en seco, dominio personalizado, _redirects y _headers, almacenamiento en caché, 404, vistas previas. Leer en el paso 3.
  • references/forms.md: el marcado del formulario, el Worker del formulario probado, pruebas locales con claves de prueba de Turnstile, configuración de producción. Leer en el paso 4 cuando la página tenga un formulario.
  • references/analytics.md: configuración de Web Analytics, el evento de conversión en Analytics Engine, la consulta, declaraciones de privacidad, qué verificar después del despliegue. Leer en el paso 5.
  • references/ab-testing.md: el costo en el plan Free, el probado

…

[truncado para traducción]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

Skills relacionados